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me 

你 手 里 正 拿 着 或 正在 屏幕 上 翻 看 的 这 本 书 ， 是 一 系列 研究 的 成 
果 。 我 们 调查 了 世界 各 地 的 多 个 团队 如 何在 很 短 的 周期 内 说 明 需 求 、 
开发 软件 ， 并 交付 正确 的 、 无 缺陷 的 产品 。 本 书 呈 现 的 是 集体 智慧 ， 
从 公共 网 站 到 内 部 支持 系统 ， 涉 及 大 大 小 小 约 50 个 项 目 。 这 些 项 目 包 
含 了 各 种 各 样 的 团队 ， 有 在 一 个 办 公 室 里 办 公 的 小 团队 ， 也 有 跨越 大 
洲 的 集团 公司 ， 他 们 使 用 了 众多 过 程 ， 包 括 极限 编程 (XP)、Scrum、 
看 板 (Kanban) 以 及 一 些 类 似 的 方法 (通常 附带 有 敏捷 或 精益 的 字 
PR) 。 这 些 项 目 有 个 共同 点 一 一 项 目 需求 说 明和 测试 能 够 恨 好 配合 ， 
项 目 组 从 中 获 益 良 多 。 

实例 化 需求 说 明 

如 何 处 理 需求 说 明 与 测试 ， 不 同 的 团队 使 用 不 同 的 名 称 ， 但 它们 
都 有 一 套 共 同 的 核心 原则 与 思想 ， 而 我 认为 它们 在 本 质 上 是 一 致 的 。 
很 多 团队 使 用 以 下 这 些 名 称 来 命名 这 类 实践 : 

敏捷 验收 测试 

验收 测试 驱动 开发 

实例 驱动 开发 

故事 测试 

行为 驱动 开发 

实例 化 需求 说 明 

相同 的 做 法 却 有 如 此 多 的 名 字 ， 这 事实 上 也 反映 了 当前 在 这 一 领 
域内 有 着 大 量 的 创新 。 同 时 它 还 反映 了 一 个 事实 ， 本 书 描述 的 这 些 做 
法 ， 影 响 了 团队 的 需求 摘 述 、 开 发 和 测试 等 方面 。 为 保持 一 致 ， 必 须 
选择 一 个 名 字 。 本 书 将 采用 实例 化 需求 说 明 (Specification by Example) 
这 个 名 称 。 至 于 为 何 选 它 ， 稍 后 的 “ 谈 谈 术 语 ” 一 节 将 详细 解释 。 

实践 出 真知 


本 书 通过 案例 研究 和 访谈 来 呈现 这 个 话题 。 之 所 以 选择 这 种 方 
式 ， 是 为 了 让 读者 能 看 到 目前 真 的 有 团队 正在 这 么 做 ， 并 且 从 中 获 益 
良 多 。 实 例 化 需求 不 是 一 门神 秘 艺 术 ， 虽 然 有 些 主流 媒体 会 使 人 这 么 
觉得 。 

书 中 的 一 切 几乎 都 是 来 自 于 现实 世界 、 真 实 的 团队 以 及 切实 的 经 
验 。 有 一 小 部 分 实践 是 作为 建议 提出 的 ， 并 没有 真实 案例 研究 的 支 
持 。 我 认为 这 些 思想 对 将 来 会 很 重要 ， 也 正 是 因为 如 此 ， 我 才 明确 地 
提出 它们 。 

我 很 确定 ， 我 所 主导 的 研究 以 及 我 得 出 的 结论 ， 虽 然 促 成 了 本 书 
的 编写 ， 但 由 于 这 并 不 是 一 项 严肃 的 科学 研究 ， 将 会 被 那些 号 称 敏捷 
开发 不 可 用 、 业 界 应 该 回 到 “真正 的 软件 工程 ”0 的 怀疑 论 者 所 排斥 。 
那 也 没关系 。 相 比 一 项 严肃 的 科学 研究 所 需 的 资源 ， 编 写本 书 时 我 接 
触 到 的 资源 是 十 分 有 限 的 。 但 即使 我 拥有 那些 资源 ， 我 也 不 是 一 个 科 
学 家 ， 而 且 我 也 不 用 伪装 我 自己 。 我 是 一 名 实践 者 。 


注释 : GD 关于 工程 学 的 严谨 有 助 于 软件 开发 的 错觉 (如同 二 流 的 
物理 学 分 支 ) ， 可 参见 http://www.semat.org。 想 更 多 了 解 对 此 错觉 的 
有 反击， 请 参考 Glenn Vanderburg 的 演讲 “软件 工程 没 用 ! ” 
(http://confreaks.net/videos/282-lsrc2010-real-software-engineering)o 


本 书 读者 对 象 

如 果 你 像 我 一 样 ， 是 一 名 实践 者 ， 并 且 靠 软件 谋生 ， 那 么 这 本 书 
可 以 提供 很 多 帮助 。 有 些 团 队 已 经 党 试 去 实施 敏捷 过 程 ， 并 且 碰 到 了 
低 质量 、 返 工 以 及 未 达 客户 预期 等 问题 ， 本 书 主 要 就 是 写 给 这 些 团队 
的 。 〈 没 错 ， 这 些 都 是 问题 。 简 单 地 迭代 只 是 权宜 之 计 ， 并 非 解决 方 
案 。) 实例 化 需求 说 明 、 敏 捷 验 收 测试 、 行 为 驱动 开发 ， 以 及 其 他 不 
同 叫 法 所 指 的 这 个 实践 ， 都 能 解决 这 些 问题 。 无 论 你 是 测试 人 员 、 开 
发 人 员 、 业 务 分 析 师 ， 还 是 产品 负责 人 ， 这 本 书 都 可 以 帮助 你 开始 实 
施 这 些 实 践 ， 并 学 习 如 何 用 它们 在 团队 中 做 出 更 多 贡献 。 


几 年 前 ， 我 在 大 会 上 碰 到 的 大 多 数 人 都 没 听 说 过 这 些 思 想 。 而 现 
在 ， 我 碰 到 的 大 部 分 人 都 或 多 或 少 知道 这 些 实践 ， 但 是 很 多 人 都 未 能 
妥善 落实 。 在 实施 敏捷 开发 的 过 程 中 ， 团 队 碰 到 的 问题 通常 都 很 少 有 
文字 记载 ， 所 以 每 一 个 受挫 的 团队 都 认为 ， 自 己 遇 到 的 问题 比较 特 
殊 ， 而 这 些 理念 无 法 在 他 们 的 “现实 世界 ”里 发 挥 作用 。 只 需 听 他 们 述 
说 短 短 五 分 钟 ， 我 就 能 猜 中 三 四 个 他 们 碰 到 的 最 大 问题 ， 这 让 他 们 觉 
得 惊讶 。 而 当 他 们 得 知 其 他 团队 也 有 同样 的 问题 时 ， 他 们 更 是 完全 惊 
末了 。 

如 果 你 也 在 这 样 的 团队 当中 ， 那 么 本 书 为 你 做 的 第 一 件 事情 ， 将 
是 告诉 你 “你 并 不 孤单 "本 书 中 我 所 采访 的 那些 团队 并 不 完美 一 一 他 
们 也 曾 遇 到 数 不 清 的 问题 。 但 他 们 在 碰壁 之 后 ， 并 没有 放弃 ， 而 是 决 
定 围绕 这 些 问 题 继 续 努 力 并 解决 问题 。 了 解 这 一 点 通常 能 鼓舞 人 们 换 
一 种 眼光 去 看 待 目 己 的 问题 。 我 希望 你 在 读 罢 本 书后 也 有 同样 的 感 


Zo 


如 果 你 正在 实施 实例 化 需求 说 明 ， 本 书 将 就 如 何 解决 你 当前 的 问 
题 提供 非常 有 用 的 建议 ， 同 时 也 能 让 你 了 解 未 来 会 友 生 什么 事情 。 我 
希望 你 可 以 从 别人 的 错误 中 汲取 经 验 ， 并 且 完 全 避免 发 生 同样 的 问 
题 。 

本 书 也 写 给 有 经 验 的 实践 者 ， 以 及 那些 在 实施 实例 化 需求 说 明 的 
过 程 中 相对 成 功 的 人 们 。 在 采访 开始 之 初 ， 我 本 以 为 这 些 事情 都 已 胸 
有 成 竹 ， 只 是 在 求证 而 已 。 结 果 我 发 现 ， 人 们 在 实施 过 程 中 居然 有 如 
此 之 多 的 想法 ， 这 是 我 始 料 未 及 的 。 我 从 这 些 案例 中 学 到 了 很 多 ， 希 
望 你 也 如 此 。 这 里 所 描述 的 实践 和 想法 ， 应 该 会 激发 你 的 灵感 ， 促 使 
你 对 自己 的 问题 尝试 变通 方案 ,或 者 让 你 在 见 过 类 似 的 故事 之 后 ， 意 
识 到 可 以 如 何 改善 团队 的 过 程 。 

本 书 内 容 

在 第 一 部 分 ， 我 会 介绍 实例 化 需求 说 明 。 我 不 会 说 服 你 为 什么 应 
该 遵循 本 书 描述 的 原则 ， 而 是 向 你 展示 一 一 用 实例 化 需求 说 明 的 方式 
一 一 团队 从 这 个 过 程 中 获 益 的 例子 。 如 果 你 在 考虑 购买 这 本 书 ， 请 浏 


览 一 下 第 1 章 ， 看 看 有 哪些 好 处 可 以 带 到 你 的 项 目 中 。 第 2 章 介 绍 了 天 
键 的 过 程 模式 和 实例 化 需求 说 明 的 关键 工件 (artifacD。 在 第 3 章 ， 我 会 
更 详细 地 解释 活 文档 的 概念 。 第 4 章 会 展示 一 些 改变 过 程 和 团队 文化 的 
最 常见 的 切入 点 ， 也 会 就 开始 过 程 实施 时 需要 注意 的 地 方 给 出 一 些 建 
议 。 

本 书写 作 的 一 个 目的 是 为 团队 在 实施 实例 化 需求 说 明 时 使 用 的 这 
些 模式 、 想 法 和 工件 创建 一 致 的 语言 。 整 个 实践 在 业界 有 许多 名 称 ， 
里 面 各 种 要 素 的 名 称 更 是 多 出 一 倍 。 不 同 的 人 分 别 将 同一 个 东西 叫 作 
功能 文档 、 故 事 测 试 、BDD 文 档 、 验 收 测试 等 。 正 因为 如 此 ， 在 第 2 
章 中 我 会 对 所 ”有 的 关键 要 素 介绍 一 些 我 感觉 不 错 的 名 字 。 即 使 你 非 
单 有 经 验 了 ， 我 还 是 建议 阅读 这 1 章 ， 以 确保 我 们 对 本 书 中 的 关键 名 
字 、 用 词 和 模式 的 理解 是 一 样 的 。 

在 第 二 部 分 ， 我 会 展示 案例 中 的 团队 用 来 实现 实例 化 需求 说 明 原 
则 的 关键 性 实践 。 不 同 环境 中 的 团队 会 做 非常 不 同 的 事 ， 有 时 甚至 为 
了 达到 相同 效果 采取 相反 或 冲突 的 措施 。 除 了 实践 外 ， 我 还 记录 了 团 
队 贯 彻 基本 原则 的 环境 。 第 二 部 分 差不多 按照 过 程 区 域 分 成 7 章 。 

在 软件 领域 没有 最 佳 实践 ， 但 是 确实 有 一 些 好 的 想法 我 们 可 以 尝 
试 在 不 同 的 环境 中 去 使 用 。 在 第 二 部 分 中 ， 有 些小 节 标 题 旁 边 会 有 拇 
指向 上 或 向 下 的 图 标 ， 代 表 的 是 调查 中 一 些 团队 觉得 有 用 的 做 法 ， 或 
者 是 他 们 经 党 遇 到 的 问题 。 请 根据 建议 做 适当 的 尝试 或 回避 ， 但 不 要 
完全 照搬 套用 。 莘 头 图 标 出 现 的 地 方 代表 的 是 各 种 做 法 的 精髓 。 

软件 开发 不 是 静态 的 一 一 团队 和 环境 都 在 改变 ， 过 程 也 必须 随 着 

变 。 在 第 三 部 分 中 ， 案 例 分 析 展 示 了 一 些 团队 的 实施 历程 。 我 记录 
了 他 们 的 过 程 、 约 束 条 件 和 环境 ， 并 分 析 了 这 些 过 程 是 如 何 演化 的 。 
这 些 故 事 有 助 于 你 迈 开 第 一 步 或 让 你 更 进一步 ， 并 发 现 新 的 想法 与 做 
事 方式 。 

本 书 的 最 后 一 章 ， 我 总 结 了 我 从 促成 本 书 的 案例 分 析 中 学 到 的 关 
He BB Ro 

更 上 一 层 楼 


在 传统 的 学 习 模 型 守 破 离 (Shu-ha-ri) 中 ， 本 书 处 于 破 的 层次 。 破 
是 说 要 打破 陈旧 的 规则 ， 并 证 明成 功 的 模型 有 很 多 。 在 我 的 Bridging 
the communication Gap 一 书 中 ， 我 展示 了 我 的 模型 及 经 验 。 本 书 中 ， 
我 尽量 不 带 进 以 前 的 背景 。 只 有 当 我 觉得 有 重要 观点 需要 证 明 ， 并 且 
本 书 中 提 到 的 其 他 任何 团队 都 没有 类 似 情 况 的 时 候 ， 我 才 会 展示 那些 
我 自己 参与 过 的 项 目 。 从 这 个 意义 上 讲 ， 本 书 在 Bridging the 
Communication Gap 的 基础 上 更 进 了 一 步 。 


注释 : (V“ 守 破 离 ” 是 来 自 于 “ 合 气 道 ”( 日 本 的 一 种 自卫 拳术 ) 招 
式 的 学 习 模 型 。 它 包含 三 个 层次 。 第 一 层 “ 守 ”， 学 员 必 须 严格 学 习 一 
种 招式 。 第 二 层 “ 破 ”*”， 学 员 知 道 除了 他 所 学 的 招式 外 还 有 很 多 招式 。 
第 三 层 “ 离 "， 学 员 脱 离 招 式 的 束缚 。 


我 会 在 第 2 章 简单 介绍 一 些 基本 的 原则 。 即 使 你 以 前 从 未 听 说 过 这 
些 想法 ， 第 2 章 的 简介 也 应 该 可 以 给 你 足够 的 信息 去 理解 本 书 的 其 余部 
分 ， 但 我 不 会 过 多 地 深入 基础 的 内 容 。 有 关 实 例 化 需求 说 明 的 基础 内 
容 在 Bridging the Communication Gap 一 书 中 有 详细 的 描述 ， 我 不 想 在 
本 书 中 重复 。 

如 果 你 想 更 详尽 地 重 温 那些 基础 内 容 ， 请 访问 
http://specificationbyexample.com， 登 记 你 购买 了 本 书 ， 就 可 免费 获得 
Bridging the Communication Gap 的 PDF 版 本 。 

我 想 今后 我 不 会 就 这 一 主题 续 写 “ 离 ” 这 个 层次 的 书籍 因为 该 
层次 是 超越 书籍 的 。 另 一 方面 ， 我 相信 本 书 可 以 帮助 你 到 达 “ 离 ”这 一 
层次 。 一 旦 你 开始 觉得 选择 什么 工具 已 经 无 关 紧 要， 那么 你 就 已 经 达 
到 了 这 个 层次 。 

本 书 没有 源 代码 ， 也 不 介绍 任何 工具 

本 书 没有 源 代码 ， 也 没有 特定 工具 的 使 用 说 明 。 我 觉得 必须 事先 
说 明 这 一 点 ， 因 为 在 出 版 过 程 中 ， 我 就 曾 多 次 向 别人 解释 这 一 点 (A 
型 的 问题 有 “什么 意思 ? 一 本 没有 源 代码 的 软件 开发 书 ? 这 怎么 可 


BE! ”) o 


讲 工具 的 书 讲 源 代码 的 书 


实例 化 需求 说 明 的 原则 和 实践 主要 影响 软件 交付 团队 中 的 人 员 沟 
通 ， 以 及 他 们 如 何 同 使 用 者 和 项 目 干 系 人 进行 协作 。 我 确信 许多 工具 
供应 商会 试图 卖 给 你 一 套 技术 方案 。 如 果 有 工具 可 以 立即 消除 遇 到 的 
问题 ， 许 多 经 理会 乐于 为 此 买单 。 不 邓 的 是 ， 他 们 遇 到 的 主要 是 人 的 
问题 ， 而 不 是 技术 问题 。 

比尔 - 盖 尝 说 过 :“ 在 企业 中 应 用 任何 一 项 技术 时 ， 首 要 的 法 则 
是 ， 在 有 效率 的 系统 中 导入 自动 化 ， 将 使 效率 倍增 。 第 二 条 法 则 是 ， 
在 缺乏 效率 的 系统 中 导入 自动 化 ， 会 使 效率 更 低下 。” 很 多 团队 在 使 用 
实例 化 需求 说 明 的 时 候 失 败 了 ， 他 们 使 用 自动 化 工具 反而 导致 他 们 的 
过 程 更 加 低 效 。 我 不 想 把 注意 力 放 在 特定 的 工具 上 ， 相 反 ， 我 想 侧重 
分 析 团 队 努 力 实现 这 些 想法 的 真实 原因 。 一 旦 你 们 能 正确 地 沟通 和 协 
作 ， 你 们 就 可 以 选择 适合 的 工具 去 使 用 。 在 阅读 本 书后 ， 如 果 你 想 知 
道 更 多 支持 实例 化 需求 说 明 的 工具 ， 请 访问 
http://specificationbyexample.com 并 查看 资源 部 分 。 

谈 谈 术语 

如 果 这 是 你 首次 听 说 实例 化 需求 说 明 、 验 收 测试 驱动 开发 、 敏 捷 
验收 测试 、 行 为 驱动 开发 ， 或 者 人 们 为 这 类 做 法 所 起 的 任何 其 他 名 
字 ， 你 应 该 庆 笠 自己 没有 被 这 些 误导 性 的 名 字 所 困扰 。 你 应 该 放 轻 松 


些 ， 而 且 你 可 以 跳 过 这 个 部 分 。 如 果 你 已 经 接触 过 那些 做 法 ， 我 在 本 
书 中 使 用 的 名 字 可 能 会 让 你 感到 惊讶 。 请 接着 读 下 去 ， 这 样 你 就 能 理 
解 为 什么 我 使 用 这 些 名 字 ， 并 且 你 也 应 该 开始 使 用 它们 。 

在 我 编写 本 书 的 时 候 ， 我 也 遇 到 了 实践 者 们 在 编写 他 们 的 自动 化 
需求 说 明 时 经 常 遇 到 的 问题 。 术 语 应 该 要 一 致 ， 这 样 才能 易于 理解 ， 
当 把 内 容 编 写成 文 时 很 有 必要 明白 这 一 点 。 本 书 是 一 系列 访问 的 产 
物 ， 很 多 我 交谈 过 的 人 使 用 不 同 的 名 字 来 措 称 同一 件 事 情 ， 这 样 的 
适 ， 要 想 保持 所 讲 故事 的 一 致 就 是 相当 困难 的 。 

我 意识 到 ， 实 例 化 需求 说 明 的 实践 者 ， 包 括 我 自己 ， 通 常会 因为 
使 用 技术 术语 ， 导 致 我 们 自己 以 及 其 他 尝试 实施 这 些 实践 的 人 都 很 迷 
惑 ， 这 让 我 们 感到 内 妆 。 因 此 我 决定 ， 编 写本 书 的 其 中 一 个 目标 ， 就 
是 要 改变 社区 中 使 用 的 术语 。 让 业务 人 员 更 多 地 参与 进来 是 这 些 实践 
的 一 个 主要 目标 ， 为 此 我 们 必须 使 用 适当 的 名 字 去 描述 那些 正确 的 做 
法 ， 不 要 再 让 人 们 感到 困惑 。 

当 我 们 编写 需求 说 明 时 ， 这 个 教训 是 显而易见 的 。 我 们 都 知道 应 
该 要 保持 术语 的 一 致 性 ， 避 免 使 用 具有 误导 性 的 术语 。 但 当 我 们 谈论 
过 程 的 时 候 ， 我 们 没有 那么 做 。 例 如 ， 当 我 们 在 实例 化 需求 说 明 的 环 
境 中 说 持续 集成 的 时 候 ， 我 们 并 不 是 说 要 运行 集成 测试 。 因 此 ， 为 什 
么 要 使 用 这 个 术语 ， 然 后 不 得 不 给 其 他 人 解释 验收 测试 与 集成 测试 的 
不 同 ? 在 我 开始 使 用 需求 说 明 工 作坊 (specification workshop) 这 个 名 字 
来 代表 有 关 验 收 测试 的 集体 会 议 前 ， 很 难说 服 业 务 人 员 去 参加 。 一 个 
简单 的 名 字 变 更 就 解决 了 这 个 问题 。 通 过 使 用 更 好 的 名 字 ， 我 们 可 以 
避免 许多 毫 无 意义 的 讨论 ， 马 上 就 让 大 家 走 上 正确 的 道路 。 

为 什么 使 用 “实例 化 需求 说 明 ” 这 个 名 字 

首先 我 想 解 释 一 下 ， 为 什么 我 选择 实例 化 需求 说 明 作 为 这 些 实践 
的 总 称 ， 而 没有 使 用 敏捷 验收 测试 、 行 为 驱动 开发 或 者 验收 测试 驱动 
开发 。 

在 2010 年 的 伦敦 领域 驱动 开发 交流 大 会 上 ，Eric Evans 跟 别人 争 
论 ， 说 敏捷 作为 一 个 术语 已 经 失去 了 一 切 意 义 ， 因 为 现在 什么 都 可 以 


称 为 敏捷 。 很 不 驻 的 是 ， 他 是 正确 的 。 尽 管 有 大 量 的 车 作 讲 如 何 正确 
地 实施 极限 编程 、Scrum 以 及 其 他 不 那么 流行 的 敏捷 过 程 ， 但 我 见 过 
太 多 太 多 的 团队 ， 试 图 去 实现 冠 以 敏捷 一 词 的 过 程 ， 但 那些 过 程 又 显 
而 易 见地 违背 了 敏捷 的 精神 。 


注释 : (Dhttp://skillsmatter.com/event/design-architecture/ddd- 
exchange-2010 


为 了 避免 这 种 关于 敏捷 是 否 可 行 (以 及 什么 是 敏捷 ) 的 无 意义 争 
论 ， 在 本 书 中 ， 我 尽量 避免 使 用 敏捷 这 一 术语 。 只 有 当 我 提 到 的 团队 
基于 敏捷 宣言 概括 的 原则 定义 了 良好 的 过 程 ， 并 开始 实施 时 ， 我 才 会 
使 用 它 。 由 于 不 会 经 常 提 到 敏捷 这 一 术语 ， 敏 捷 验 收 测试 这 个 名 称 也 
就 无 从 谈 起 了 。 

这 里 描述 的 实践 没有 形成 一 个 成 熟 的 软件 开发 方法 论 。 它 们 可 以 
补充 其 他 方法 论 一 一 无 论 是 基于 迭代 还 是 基于 工作 流 的 一 一 使 需求 说 
明和 测试 更 加 严 着 ， 增 强 不 同 项 目 干 系 人 和 软件 开 友 团队 成 员 之 间 的 
沟通 、 减 少 不 必 要 的 返工 ， 并 让 改变 更 加 容易 。 因 此 我 不 想 使 用 任何 
“驱动 开发 ”之 类 的 名 字 ， 尤 其 不 会 使 用 行为 驱动 开发 (BDD) 的 字眼 。 
不 要 认为 这 说 明 我 反对 BDD。 人 恰恰 相反 ， 我 喜欢 BDD， 而 且 我 认为 本 
书 实 际 上 主要 在 讲 BDD 的 核心 内 容 。 但 BDD 同 样 有 名 字 层 义 的 问题 。 

BDD 到 底 代 表 了 什么 总 是 在 变化 。 关 于 什么 是 BDD， 什 么 不 是 
BDD, Dan North 是 最 具 话 语 权 的 。 在 Agile Specifications, BDD, and 
Testing Exchange 2009 上 ， 他 说 BDD 是 一 种 方法 论 。 (事实 上 ， 他 将 
其 称 为 “第 二 代 的 、 由 外 而 内 的 、 基 于 拉动 的 、 多 项 目 干 系 人 、 多 尺度 
的 、 高 度 自 动 化 的 敏捷 方法 。”) 为 了 避免 在 North 所 说 的 BDD 和 我 理 
解 中 的 BDD 之 间 产 生 任 何 混 淆 和 歧义 ， 我 不 想 使 用 这 个 名 字 。 本 书 讲 
的 是 一 组 宝贵 的 实践 ， 在 很 多 方法 论 中 你 都 可 以 使 用 ， 包 括 BDD (如 
果 你 能 接受 BDD 是 一 种 方法 论 的 说 法 ) o 


注释 : (Dhttp://skillsmatter.com/podcast/java-jee/how-to-sell-bdd-to- 
the-business 


我 也 想 尽 量 避 人 免 使 用 测试 这 个 字眼 。 很 不 立地 ， 很 多 经 理 和 业务 
人 员 认 为 测试 是 一 种 技术 辅助 活动 ， 不 是 他 们 想 参 与 的 事情 。 毕 竞 ， 
他 们 有 专门 的 测试 人 员 去 处 理 这 件 事 情 。 实 例 化 需求 说 明 要 求 项 目 干 
系 人 以 及 交付 团队 的 成 员 (包括 测试 人 员 、 开 发 人 员 、 业 务 分 析 人 
A) 积极 地 参与 进去 。 只 要 我 们 在 标题 中 不 放 入 测试 这 样 的 词汇 ， 那 
么 故事 测试 、 敏 捷 验 收 测试 以 及 其 他 类 似 的 名 字 自 然 就 不 会 出 现 。 

这 让 实例 化 需求 说 明成 为 了 最 有 意义 的 名 字 ， 它 的 负面 影响 最 
小 。 

过 程 模式 

实例 化 需求 说 明 由 一 些 过 程 模式 (Process Pattern) 组 成 ， 后 者 是 更 
广义 的 软件 开发 生命 周期 的 组 成 要 素 。 本 书 中 我 用 的 名 字 是 在 英国 敏 
捷 测 试用 户 组 会 议 、 敏 捷 联 盟 功能 测试 工具 邮件 组 以 及 工作 坊 中 经 过 
一 系列 讨论 得 到 的 。 其 中 有 些 名 字 已 经 用 了 一 段 时 间 ， 而 另 一 些 大 多 
数 读者 还 比较 阳 生 。 

业内 流行 用 一 个 实践 或 工具 的 名 字 来 描述 过 程 的 一 部 分 。 功 能 ; 
入 (Feature Injection) 就 是 一 个 很 好 的 例子 一 一 用 它 来 描述 从 商业 目标 中 
获取 项 目 范 围 这 一 过 程 ， 就 很 受 欢 迎 。 但 是 功能 注入 只 是 其 中 一 种 技 
术 ， 还 有 其 他 方法 可 以 达到 同样 的 目的 。 为 了 讨论 不 同 的 团队 在 不 同 
的 环境 中 做 什么 ， 我 们 需要 更 宏观 的 概念 来 襄 括 所 有 这 些 实践 。 一 个 
好 的 名 字 能 很 好 地 说 明 预 期 的 结果 ， 并 且 清 晰 地 指出 这 些 实 践 的 关键 
KA. 

以 功能 注入 与 类 似 实践 为 例 ， 其 结果 就 是 项 目 或 里 程 碑 的 一 个 范 
畴 。 与 其 他 定义 范围 的 方法 相 比 ， 关 键 区 别 在 于 ， 我 们 专注 的 是 商业 
目标 。 因 此 我 提出 从 目标 中 获取 范围 (deriving scope from goals) 这 一 概 

在 实例 化 需求 说 明 过 程 中 ， 团 队 碰 到 的 最 大 的 一 个 问题 是 : 谁 应 
该 在 什么 时 候 写 些 什 么 东西 。 所 以 我 们 需要 一 个 好 名 字 来 明确 地 说 明 
大 家 都 应 参与 (需要 在 团队 开始 编码 或 测试 前 做 ) ， 因 为 我 们 要 使 用 
验收 测试 作为 开发 的 目标 。 测 试 先 行 (Test First) 是 个 不 错 的 技术 名 词 ， 


然而 商业 用 户 并 不 能 理解 ， 更 何况 它 没有 包含 合作 的 意思 。 我 建议 我 
们 关注 通过 协作 制定 需求 说 明 (specifying collaboratively), MAEM 
先 或 写 验收 测试 。 

听 起 来 很 普通 ， 只 是 把 每 个 数字 上 的 可 能 性 考虑 进 自动 化 功能 测 
试 里 。 如 果 自 动 化 了 ， 我 们 为 什么 不 这 么 做 ? 但 是 如 此 复杂 的 测试 作 
为 沟通 工具 是 无 法 使 用 的 ， 在 实例 化 需求 说 明 里 ， 我 们 是 要 用 测试 来 
沟通 。 因 此 不 是 编写 功能 测试 ， 而 是 关注 举例 说 明 (illustrating using 
examples)， 并 且 期 望 它 能 输出 关键 实例 (key examples) 这 些 实例 表明 我 
们 只 需要 恰当 地 描述 所 需 的 环境 就 可 以 了 。 


注释 : 谢谢 David Evans 给 的 建议 。 


关键 实 例 是 原料 ， 但 是 如 果 仅 仅 关 注 验 收 测试 ， 为 什么 不 干脆 就 
用 50 列 100 行 的 复杂 表格 来 作为 实例 ， 并 且 不 带 任 何 说 明 ? 反正 是 机 器 
来 测试 。 用 了 实例 化 需求 说 明 ， 测 试 既是 给 机 器 看 的 ， 也 是 给 人 看 
的 。 我 们 需要 说 清楚 的 是 ， 使 用 实例 说 明 后 ， 还 有 一 个 步骤 ， 就 是 抽 
取 属 性 和 实例 的 最 小 集合 来 说 明 业 务 规则 ， 并 加 上 标题 和 描述 等 。 我 
建议 把 这 个 步骤 称 为 提炼 需求 说 明 (refining the specification)® 。 


注释 : 名 谢谢 Elisabeth Hendrickson 建 议 的 这 个 名 字 。 


提炼 的 结果 既是 需求 说 明 ， 同 时 也 是 开发 的 目标 、 检 查验 收 的 客 
观 方 法 以 及 之 后 的 功能 回归 测试 。 我 不 想 叫 它 验收 测试 的 原因 是 ， 它 
很 难说 明 为 什么 文档 要 用 领域 语言 来 号 、 可 读 性 要 高 ， 还 要 容易 理 
解 。 我 认为 我 们 应 该 将 提炼 的 结果 称 为 带 实例 的 需求 说 明 (specification 
with examples)， 从 而 揭示 出 一 个 事实 ， 就 是 需求 说 明 需 要 基于 实例 ， 
但 绝 不 是 只 包含 原始 数据 。 将 这 个 工件 称 作 需求 说 明 可 以 明显 地 指出 
大 家 都 需要 关注 它 ， 而 且 它 需要 容易 理解 。 除 此 之 外 ， 关 于 是 否 用 这 
些 检查 来 自动 验收 软件 或 自动 拒绝 不 满足 需要 的 代码 ， 还 有 另外 一 种 
截然 不 同 的 观点 中 。 


注释 : @http://www.developsense.com/blog/2010/08/acceptance- 
tests-lets-change-the-title-too 


我 不 想 再 花 时 间 和 那些 买 了 QTP 的 人 争论 ， 告 诉 他 们 QTP 对 验收 
测试 完全 没有 用 。 只 要 我 们 谈论 测试 自动 化 ， 总 有 人 推销 测试 人 员 已 
经 用 来 做 自动 化 的 可 怕 玩 意 儿 。 敏 捷 验 收 测试 和 BDD 工 具 与 QTP 之 类 
的 工具 有 很 大 的 差别 ， 它 们 处 理 完全 不 同 的 问题 。 不 应 将 需求 说 明 解 
释 成 一 种 自动 化 的 技术 。 我 们 把 在 不 至 曲 任何 信息 的 情况 下 将 验证 自 
动 化 称 作 自 动 化 验证 而 不 改变 需求 说 明 (automating validation without 
changing specifications)， 而 非 验证 自动 化 。 不 改变 原 有 需求 说 明 的 自 
动 化 验证 可 以 帮助 我 们 避免 可 怕 的 脚本 和 在 测试 需求 说 明 中 直接 使 用 
技术 类 库 。 可 执行 的 需求 说 明 应 该 与 在 白板 上 看 到 的 一 样 ， 而 不 应 该 
转译 成 Seleninum 命 令 。 

在 将 需求 说 明 验 证 自动 化 后 ， 我 们 可 以 用 它 来 验证 系统 。 事 实 
上 ， 我 们 得 到 了 可 执行 的 需求 说 明 (executable specification)。 

我 们 要 频繁 地 检查 所 有 的 需求 说 明 ， 确 保 系 统 还 在 按 所 期 望 的 运 
行 ， 同 样 重 要 的 是 确保 需求 说 明 还 能 描述 系统 的 行为 。 如 果 我 们 将 这 
称 作 回归 测试 ， 那 么 很 难 向 测试 人 员 解 释 为 什么 他 们 不 应 该 在 之 前 既 
小 又 好 而 且 明 确 的 需求 说 明 中 再 加 500 万 个 测试 用 例 。 如 果 再 提 到 持 
续集 成 ， 我 们 将 很 难 解释 为 什么 不 总 是 端 到 端 地 运行 这 些 测 试 ， 并 检 
查 整个 系统 。 对 于 一 些 遗 留 系统 ， 我 们 需要 针对 一 个 部 署 好 的 正在 运 
行 中 的 环境 来 运行 验收 测试 。 技 术 上 的 集成 测试 应 在 部 署 前 运行 。 所 
以 我 们 不 谈 回归 测试 或 持续 集成 ， 我 们 谈 频 繁 验 证 (validating 
frequently). 

实例 化 需求 说 明 具 有 长 期 回报 ， 前 提 是 拥有 一 个 对 系统 自身 功能 
的 引用 ， 该 引用 具有 与 代码 一 样 的 价值 ， 但 是 更 易 读 懂 。 长 期 来 说 ， 
这 使 得 开发 有 效率 得 多 ， 能 促进 与 商业 用 户 的 合作 ， 促 成 软件 设计 和 
商业 模型 的 一 致 ， 并 且 使 大 家 工作 更 简单 。 但 是 要 做 到 这 点 ， 该 引用 
必须 有 意义 ， 必 须 有 人 维护 ， 而 且 还 必须 内 部 保持 一 致 ， 并 与 代码 保 
持 一 致 。 我 们 不 应 该 有 大 量 的 测试 还 在 用 数 年 前 使 用 的 术语 。 你 很 难 


让 忙碌 的 团队 回 过 头 去 更 新 测试 ， 但 是 在 重大 改变 之 后 回头 去 更 新 文 
档 ， 这 是 大 家 所 愿意 看 到 的 。 所 以 我 们 不 要 关注 那些 含有 数 特 个 测试 
的 文件 夹 ， 让 我 们 把 注意 力 放 到 演化 活 文档 系统 (evolving a living 
documentation system) 上 。 这 样 就 更 容易 解释 ， 为 什么 很 多 事情 必须 不 
言 而 喻 ， 为 什么 商业 用 户 也 需要 使 用 这 些 ， 为 什么 需要 良好 地 组 织 以 
方便 查找 。 

所 以 情况 就 是 这 样 : 我 选择 了 这 些 名 字 ， 不 是 因为 它们 以 前 很 流 
行 ， 而 是 因为 它们 有 意义 。 这 些 过 程 模式 的 名 字 必 须 创建 一 种 思考 模 
型 ， 该 模型 可 以 明确 地 指出 那些 重要 的 事 ， 并 且 减 少 困 惑 。 我 希望 你 
能 明白 这 点 ， 并 接受 这 个 新 的 术语 。 
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第 1 章 主要 优点 


在 互联 网 时 代 ， 交 付 速度 是 当今 软件 开发 的 主题 。 十 年 前 ， 项 目 
通常 要 持续 好 几 年 ， 并 且 项 目 阶 段 是 以 月 来 衡量 的 。 如 今 ， 多 数 团队 
的 项 目 周 期 是 按 月 来 衡量 的 ， 而 项 目 阶段 则 减少 到 几 周 甚至 几 天 。 任 
何 需 要 长 远 规划 的 东西 都 将 被 抛 奔 ， 比 如 大 量 的 前 期 软件 设计 和 详细 
的 需求 分 析 。 超 过 项 目 阶 段 平 均 周期 的 任务 将 不 复 存 在 。 跟 代码 冻结 
(Code Freeze) 以 及 数 周 的 手动 回归 测试 说 再 见 吧 ! 

变化 频率 如 此 之 高 ， 文 档 很 快 就 会 过 时 。 不 断 更 新 详细 需求 说 明 
和 测试 计划 (Test Plan) 需 要 投入 大 量 精力 ， 相 当 浪 费 。 那 些 以 往 在 日 常 
工作 中 依赖 于 此 的 人 们 ， 如 业务 分 析 师 或 者 测试 人 员 ， 在 这 个 每 周 迭 
代 的 新 环境 中 经 常会 无 所 适 从 。 开 发 人 员 原 本 以 为 不 会 受到 纸 质 文 档 
缺失 的 影响 ， 现 在 却 要 把 时 间 浪 费 在 不 必要 的 返工 与 功能 维护 上 。 他 
们 不 是 花 时 间 去 制订 宏伟 的 计划 ， 而 是 要 浪费 数 周 的 时 间 去 修正 有 问 
题 的 产品 。 

在 过 去 的 十 年 里 ， 软 件 开 发 社区 致力 于 使 用 “正确 ”的 方式 来 构建 
软件 ， 关 注 使 用 技术 实践 和 思想 来 确保 质量 。 但 是 ， 正 人 确 地 构建 产品 
和 构建 正确 的 产品 是 两 码 事 。 我 们 要 二 者 兼顾 才能 取得 成 功 。 


正确 地 构建 


业务 失败 tE 成 功 


实例 化 需求 说 明 正确 的 产品 


无 用 的 垃圾 EAP ole A 


图 1-1 实例 化 需求 说 明 可 以 帮助 团队 构建 正确 的 软件 产品 ， 而 技术 实 
践 可 以 确保 正确 地 构建 产品 


想 要 有 效 地 构建 正确 的 产品 ， 软 件 开 发 实践 必须 满足 以 下 几 点 。 

保证 所 有 项 目 干系 人 和 交付 团队 的 成 员 都 对 需要 交付 哪些 东西 有 
一 致 的 理解 。 

有 准确 的 需求 说 明 ， 这 样 交付 团 队 才能 避免 由 模棱两可 和 功能 缺 
失 造 成 的 无 谓 返 工 。 

有 用 来 衡量 某 项 工作 是 否 已 经 完成 的 客观 标准 。 

具有 引导 软件 功 Aa 更 的 文档 。 

传统 意义 上 ， 构 建 正 确 的 产品 需要 庞大 的 功能 需求 说 明 、 文 档 以 
及 漫长 的 测试 阶段 。 如 今 ， 软 件 每 周 都 要 有 交付 ， 这 一 套 已 经 行 不 通 
了 。 我 们 寻求 的 方案 要 能 带 来 如 下 好 处 。 

避免 过 度 说 明 需 求 从 而 产生 浪费 ， 避 免 花 时 间 在 开发 前 会 发 生 改 
变 的 细节 上 。 

有 一 种 可 靠 的 文档 ， 可 以 解释 系统 的 行为 ， 据 此 我 们 能 容易 修改 
系统 行为 。 

可 以 有 效 地 检查 系统 行为 与 需求 说 明 的 描述 是 否 一 致 。 

以 最 少 的 维护 成 本 维持 文档 的 相关 性 与 可 靠 性 。 


适合 短 和 迭代 和 基于 流 的 过 程 ， 这 样 能 为 即将 开展 的 工作 提供 即时 
足够 的 信息 。 


敏捷 团队 构建 正确 
产品 所 需 的 文档 


精确 的 ， 
客观 上 
可 测试 的 


图 1-2 对 于 敏捷 项 目 ， 构 建 正确 文档 的 关键 因素 


乍 一 看 ， 这 些 目标 似乎 互相 冲突 ， 但 有 很 多 团队 已 经 成 功 地 达成 
了 所 有 目标 。 在 为 本 书 做 调研 时 ， 我 采访 了 30 个 团队 ， 他 们 完成 了 大 
约 50 个 项 目 。 我 试图 找 出 一 些 模式 与 通用 做 法 ， 并 挖掘 出 这 些 方式 背 
后 的 基本 原则 。 这 些 项 目的 共同 思想 ， 定 义 了 一 种 构建 正确 软件 的 好 
方法 : 实例 化 需求 说 明 。 

实例 化 需求 说 明 是 一 组 过 程 模式 ， 它 帮助 团队 构建 正确 的 软件 产 
品 。 使 用 实例 化 需求 说 明 ， 团 队 编 写 的 文档 数量 恰到好处 ， 在 短 迭 代 
或 基于 流 的 开发 中 可 以 有 效 地 协助 变更 。 

实例 化 需求 说 明 的 关键 过 程 模式 将 在 下 一 章 介 绍 。 本 章 我 将 前 述 
实例 化 需求 说 明 的 好 处 。 我 将 使 用 实例 化 需求 说 明 的 风格 来 进行 阐 
述 ， 而 不 是 以 理论 介绍 的 方式 来 构建 一 个 案例 ， 我 将 展示 18 个 真实 的 
例子 ， 它 们 都 来 自 于 那些 大 大 受益 于 实例 化 需求 说 明 的 团队 。 


在 开始 之 前 ， 我 想 强 调 一 下 ， 在 一 个 项 目 中 很 难 孤立 地 看 待 某 种 
思想 的 影响 或 作用 。 本 书 所 描述 的 实践 ， 可 以 与 已 经 开展 的 敏捷 软件 
开发 实践 [例如 测试 驱动 开发 (TDD)、 持 续集 成 以 及 使 用 用 户 故事 做 计 
划 等 ] 共 同 使 用 ， 而 且 可 以 增强 其 他 实践 的 效用 。 当 我 们 转 而 去 看 那些 
有 着 不 同 背 景 的 项 目 时 ， 很 多 模式 浮现 了 出 来 。 我 采访 的 团队 中 ， 有 
些 在 实施 实例 化 需求 说 明 前 一 直 使 用 敏捷 过 程 ， 而 有 些 团队 则 是 在 过 
渡 到 敏捷 过 程 的 过 程 中 实施 了 实例 化 需求 说 明 。 大 多 数 团 队 使 用 基于 
迭代 的 过 程 ， 例 如 Scrum 和 极限 编程 ， 或 者 是 基于 流 的 过 程 ， 例 如 看 
板 。 但 是 有 些 团 队 ， 尽 管 他 们 使 用 了 这 些 实践 ， 但 他 们 的 过 程 以 任何 
标准 来 看 都 不 是 敏捷 的 过 程 。 然 而 ， 他 们 大 多 都 收获 了 如 下 类 似 的 收 
蔓 。 

更 有 效 地 实施 变更 。 他 们 拥有 活 文档 一 一 系统 功能 的 可 靠 信息 来 
让 他 们 得 以 分 析 潜 在 变更 的 影响 ， 同 时 可 以 有 效 地 分 享 知识 。 
更 高 的 产品 质量 。 他 们 清晰 地 定义 了 预期 ， 使 得 验证 过 程 很 有 效 


产 


率 。 

少 的 返工 。 他 们 在 需求 说 明 上 协作 得 更 好 ， 并 确保 所 有 团队 成 
员 对 预期 达成 共识 。 

同一 项 目 不 同 角 色 的 活动 协调 得 更 好 。 改 善 协作 形成 定期 的 交付 
流程 。 

在 接 下 来 的 4 个 小 节 中 ， 我 们 将 通过 现实 世界 的 例子 ， 近 距离 地 审 
视 这 些 收益 。 


1.1 


在 为 本 书 做 调研 的 过 程 中 ， 我 获得 的 最 重要 的 经 验 是 关于 活 文档 
(living Documentation) 的 长 期 收益 的 一 一 事实 上 ， 我 认为 这 是 本 书 的 一 
个 最 重要 信息 ， 本 书 广泛 地 涵盖 了 这 部 分 内 容 。 活 文档 是 系统 功能 的 
一 个 信息 源 ， 它 与 程序 代码 一 样 可 靠 ， 但 更 容易 使 用 和 理解 。 活 文档 
帮助 团队 共同 分 析 变 更 所 带 来 的 影响 并 讨论 潜在 的 方案 。 团 队 还 可 以 
为 新 的 需求 扩展 已 有 的 文档 。 长 此 以 往 ， 可 以 使 需求 说 明和 实施 变更 


更 有 效 。 大 多 数 成 功 的 团队 都 发 现 活 文档 的 长 期 收益 是 实施 实例 化 需 
求 说 明 所 审 来 的 结果 。 

总 部 设 在 美国 西 得 梅 因 市 的 爱 和 荷 华 州 助 学 贷 款 流动 资产 管理 公司 
(Iowa Student Loan Liquidity Corporation， 下 文 简称 Iowa Student 
Loan)， 在 2009 年 进行 了 一 项 相当 重要 的 商业 模式 变更 。 过 去 一 年 ， 金 
融 市 场 动荡 使 得 贷款 方 几乎 无 法 为 私人 学 生 贷款 找到 资金 来 源 ， 因 
此 ， 许 多 贷款 方 被 迫 放 弃 私 人 学 生 贷 款 市 场 或 改变 自己 的 商业 模式 。 
该 公司 适应 了 当时 的 市 场 。 它 从 银行 和 其 他 金融 机 构 募 集资 金 来 支 助 
私人 助 学 贷款 ， 而 不 是 使 用 债券 收益 。 

Tim Andersen 是 一 位 软件 分 析 师 ， 同 时 也 是 一 名 开发 人 员 ， 他 说 
为 了 有 效 地 适应 市 场 ， 他 们 不 得 不 有声有色 地 进行 系统 核心 大 检 
修 ”。 在 开发 软件 时 ， 他 们 的 团队 把 活 文档 作为 一 项 主要 机 制 来 编写 业 
务 需求 文档 。 活 文档 系统 让 他 们 可 以 探 悉 新 需求 所 带 来 的 影响 、 帮 助 
他 们 确定 所 需 的 变更 ， 而 且 可 以 确保 系统 的 其 余部 分 仍旧 正常 工作 。 
他 们 当时 只 花 了 一 个 月 时 间 就 对 系统 实施 了 根本 性 的 变更 并 将 其 发 布 
到 了 生产 环境 ， 活 文档 系统 是 做 这 项 变更 的 根本 。Andersen 说 : 

“任何 未 进行 这 些 测试 〈 活 文档 ) 的 系统 ， 都 必 将 导致 开发 停顿 和 
BS,” 

在 加 拿 大 魁北克 省 的 蒙特 利 尔 市 ，Pyxis 技 术 公司 的 Talia 项 目 团队 
也 有 类 似 的 经 验 。Talia 是 企业 系统 的 一 个 虚拟 助理 ， 它 是 一 个 拥有 复 
杂 规 则 、 能 与 员工 交流 的 聊天 机 器 人 。 从 最 初 开始 ，Talia 团 队 就 使 用 
实例 化 需求 说 明 来 构建 一 个 活 文档 系统 。 一 年 之 后 ， 他 们 不 得 不 从 头 
开始 编写 虚拟 代理 引擎 的 核心 一 一 而 此 时 ， 正 是 在 活 文档 方面 的 投资 
大 显 成 效 的 时 候 。Talia 的 产品 总 监 Andrk Brissette 是 这 样 说 的 : 

“如 果 没有 活 文档 ， 任 何 重大 重 构 都 无 疑 是 自 寻 死路 。>” 

他 们 的 活 文档 系统 使 得 团队 在 变更 完成 时 可 以 自信 地 说 ， 新 系统 
具有 和 老 系统 一 样 的 功能 。 该 活 文 档 系统 还 能 帮助 Brissette 管 理 并 追踪 
项 目的 进度 。 


总 部 位 于 伦敦 的 现场 音乐 消费 性 网 站 Songkick 的 团队 在 重新 开发 
网 站 活动 摘要 时 ， 使 用 了 一 个 活 文档 系统 来 协助 变更 。 他 们 意识 到 目 
前 的 摘要 系统 无 法 扩展 到 所 需 的 容量 ， 活 文档 在 重新 构建 摘要 系统 时 
就 提供 了 有 力 的 支持 。Phil Cownas 是 Songkick 的 CTO ， 据 他 估计 ， 
为 拥有 了 活 文 档 系统 ， 他 们 的 团队 在 实施 变更 时 节省 了 至 少 50% 的 时 
间 。 据 Cowans 所 述 : 

“因为 我 们 拥有 让 人 满意 的 覆盖 率 ， 并 且 我 们 确实 信任 这 些 (在 活 
文档 系统 里 的 ) 测试 ， 所 以 我 们 很 有 信心 可 以 快速 地 对 基础 结构 进行 
大 的 变更 。 我 们 知道 ， 系 统 功 能 不 会 改变 ， 即 使 变 了 ， 测 试 也 会 发 
现 。” 

ePlan Services 是 一 个 养老 金 服务 机 构 ， 位 于 科罗拉多 州 的 丹佛 
市 ， 它 的 开发 团队 从 2003 年 开始 就 已 经 使 用 了 实例 化 需求 说 明 。 他 们 
构建 并 维护 一 个 金融 服务 系统 ， 该 系统 涉及 众多 的 项 目 干 系 人 、 复 杂 
的 业务 逻辑 以 及 复杂 的 监管 需求 。 在 项 目 开始 三 年 之 后 ， 其 中 一 位 经 
理 搬 去 了 印度 ， 而 对 于 系统 遗留 部 分 ， 有 些 内 容 是 只 有 他 才 掌 握 的 。 
根据 ePlan Services 的 测试 人 员 及 Agile Testing:A Practical Guide for 
Testers and Teams 一 书 作者 Lisa Crispin 的 描述 ， 当 时 ， 团 队 努 力 地 学 
习 那 位 经 理 所 拥 有 的 知识 并 将 其 构建 成 活 文 档 。 活 文档 系统 帮助 他 们 ] 
获得 了 业务 流程 的 专业 知识 ， 并 立即 提供 给 所 有 的 团队 成 员 。 他 们 借 
此 消除 了 知识 传递 的 瓶颈 ， 可 以 有 效 地 支持 并 扩展 系统 。 


注释 : WW 该 书 中 文 版 名 为 《敏捷 软件 测试 : 测试 人 员 与 敏捷 团队 
的 实践 指南 》， 已 由 清华 大 学 出 版 社 于 2010 年 出 版 。 译 者 注 


在 比利时 Oostkamp 的 IHC 集 团 ， 病 人 管理 中 心 项 目 组 实施 了 一 个 
活 文档 系统 ， 并 取得 了 类 似 的 结果 。 该 项 目 开 始 时 重 写 了 一 个 大 型 机 
系统 ， 它 是 从 2000 年 开始 的 ， 目 前 还 在 进行 中 。Pascal Mestdach 是 该 
项 目的 方案 架构 师 ， 他 说 团队 从 中 受益 菲 浅 : 

“当时 遗留 系统 中 的 一 部 分 功能 只 有 少数 几 个 人 了 解 ， 而 现在 情况 
已 经 好 很 多 了 ， 那 是 因为 团队 拥有 一 套 针 对 那 部 分 功能 的 、 不 停 增 长 


的 测试 套件 〈 活 文档 ) ， 它 描述 了 该 遗留 系统 的 功能 。 当 专家 休假 
时 ， 还 可 以 从 活 文 档 系统 中 寻找 问题 的 答案 。 对 其 他 开发 人 员 来 说 ， 
可 以 更 清晰 地 了 解 软 件 中 某 部 分 的 功能 。 并 且 还 是 测试 过 的 。” 

这 些 例子 前 述 了 活 文档 系统 如 何 帮助 交付 团 队 分 享 知识 并 应 付 人 
员 变 动 。 它 还 使 得 业务 可 以 更 有 效 地 响应 市 场 变 化 。 我 将 在 第 3 章 里 对 
此 做 更 具体 的 说 明 。 


1.2 更 高 Te 


实例 化 需求 说 明 可 以 改善 交付 团队 成 员 之 间 的 协作 ， 促 进 商 业 用 
户 更 好 地 参与 ， 并 为 交付 提供 清晰 客观 的 目标 一 一 大 幅 提 高 产品 质 


wl 


有 两 个 突出 的 案例 ， 分 别 来 自 Wes Williams[ 来 自 世博 控股 (Sabre 
Holdings) 的 敏捷 教练 ] 以 及 Andrew Jackman[ 为 法 国 巴 黎 银行 (BNP 
Paribas) 的 一 个 项 目 工 作 的 顾问 开发 人 员 ]， 他 们 将 描述 之 前 失败 过 多 
次 的 项 目 如 何 通 过 实例 化 需求 说 明 走 向 成 功 。 本 书 中 描述 的 方法 帮助 
他 们 的 团队 克服 了 业务 领域 的 复杂 性 ， 之 前 这 种 复杂 性 是 很 难处 理 
的 。 同 时 还 帮助 他 们 确保 了 交付 的 高 质量 。 

在 世博 控股 ，Wes Williams 工 作 的 项 目 是 一 个 为 期 两 年 的 航班 订 
票 项 目 ， 团 队 分 布 在 全 球 各 地 ， 流 程 又 是 数据 驱动 的 ， 这 使 得 项 目 十 
分 复杂 。 项 目 有 3 个 团队 ，30 名 开发 人 员 ， 分 布 于 两 个 洲 。 据 Williams 
说 ， 系 统 头 两 次 构建 都 失败 了 ， 但 是 第 三 次 使 用 实例 化 需求 说 明 后 就 
成 功 了 。Williams 说 : 

“我 们 在 一 家 大 客户 (一 家 大 型 航空 公司 ) 上 线 时 缺陷 非常 少 ， 在 

(业务 验收 ) 测试 阶段 只 有 1 个 缺陷 是 比较 严重 的 ， 是 故障 切换 (fail- 
over) 相 关 的 问题 。” 

Williams 认 为 实例 化 需求 说 明 是 他 们 取得 成 功 的 一 个 关键 因素 。 
除了 保证 高 质量 外 ， 实 例 化 需求 说 明 还 有 助 于 建立 开发 人 员 和 测试 人 
员 之 间 的 信任 。 


在 法 国 巴 黎 银 行 ，Sierra 项 目 是 另 一 个 很 好 的 例子 ， 可 以 展现 实例 
化 需求 说 明 如 何 带 来 高 质量 的 产品 。Sierra 是 一 个 债券 的 数据 仓库 ， 整 
合 了 一 些 内 部 系统 、 评 级 机 构 和 其 他 来 自 外 部 的 信息 ， 并 将 它们 分 发 
给 银行 内 部 的 各 种 系统 。 许 多 系统 和 组 织 使 用 相同 的 术语 ， 表 达 的 意 
思 却 不 尽 相 同 ， 这 导致 了 许多 误解 。 最 初 两 次 实现 系统 的 尝试 都 失败 
了 ， 据 Channing Walton 说 ， 团 队 中 的 一 个 开发 人 员 促 使 了 第 三 次 尝试 
的 成 功 。 第 三 次 努力 的 成 功 部 分 归功 于 实例 化 需求 说 明 帮 助 团队 处 理 
了 复杂 性 问题 ， 并 且 确 保 了 团队 的 共识 。 最 终 的 产品 质量 令 人 印 销 深 
刻 。 项 目 从 2005 年 上 线 以 来 一 直 在 运行 ，Sierra 项 目的 顾问 开发 人 员 
Andrew Jackman 说 :“ 生 产 环境 中 没有 出 现 大 的 问题 。” 现 在 Sierra 项 目 
中 的 大 多 数 工 作 人 员 都 不 是 项 目 局 动 时 的 那些 人 ， 但 是 质量 水 平一 直 
都 很 高 。 

Bekk 咨 询 公 司 在 为 一 家 大 型 法 国 银 行 支行 开发 租车 系统 时 也 取得 
了 类 似 的 成 果 。Aslak Hellesgy 曾 是 那个 团队 的 成 员 ， 还 是 Cucumber 
一 一 一 个 支持 实例 化 需求 说 明 的 热门 自动 化 工具 的 创造 者 ， 据 他 说 ， 
尽管 现在 维护 这 个 软件 的 是 一 个 全 新 的 团队 ， 但 他 们 在 系统 上 线 后 的 
两 年 中 却 只 发 现 了 5 个 缺陷 。 

Lance Walton 曾 在 一 家 大 型 瑞士 银行 伦敦 分 行 的 一 个 项 目 中 担任 
过 程 顾问 ， 这 个 项 目 是 要 开发 一 个 订单 管理 系统 ， 开 始 的 几 次 也 都 失 
败 了 。Walton 进 入 这 个 项 目 时 ， 大 家 都 认为 实现 这 个 系统 需要 至 少 和 
开发 团队 一 样 大 的 支持 团队 。 他 的 团队 使 用 了 实例 化 需求 说 明 ， 项 目 
开始 9 个 月 后 就 交付 了 生产 系统 ， 一 天 内 就 通过 了 业务 验收 测试 ， 之 后 
6 个 月 内 没有 发 现任 何 缺 陷 。Walton 说 新 的 系统 不 需要 额外 的 支持 人 
员 ， 成 本 比 预期 要 低 ， 而 且 团 队 更 早 地 交付 了 成 品 。 相 比 之 下 ， 他 们 
劳 边 的 团队 需要 10 倍 于 开发 团队 的 支持 人 员 。Walton 指 出 : 

“现在 团队 依然 每 周 发 布 一 次 ， 用 户 总 是 对 它 非常 满意 。 从 质量 上 
A, CRT. ” 

实例 化 需求 说 明 的 技术 不 仅仅 适合 于 新 建 项 目 ， 同 时 也 适用 于 改 
建 项 目 。 建 立 起 值得 信赖 的 文档 、 清 理 遗 留 的 系统 ， 都 需要 一 定 的 时 


间 ， 但 是 团队 很 快 就 能 看 到 诸多 的 好 处 ， 并 对 新 的 交付 充满 信心 。 

还 有 一 个 不 错 的 例子 是 伦敦 摩根 大 通 的 外 汇 交 易 系 统 。Martin 
Jackson 是 该 项 目的 目 动 化 测试 顾问 ， 他 说 业务 分 析 员 预计 项 目 会 推 
迟 ， 然 而 事实 上 ， 项 目 提 前 两 个 星期 就 交付 了 。 高 质量 的 产品 让 他 们 ] 
成 功 地 在 一 个 星期 内 完成 了 业务 验收 测试 阶段 ， 而 不 是 原先 计划 的 4 个 
星期 。Jackson 说 : 

“我 们 部 署 好 系统 后 ， 系 统 工作 正常 。 业 务 人 员 向 董事 会 报告 说 这 
是 他 们 经 历 过 的 最 好 的 用 户 验收 测试 (UAT)。” 

实例 化 需求 说 明 还 使 Jackson 的 团队 在 项 目 开发 晚期 快速 实现 了 
“一 次 重大 的 技术 改动 "， 提 高 了 计算 的 精确 度 。Jackson 称 : 

“FitNesse 套 件 〈 活 文档 ) 覆盖 的 所 有 功能 ， 通 过 了 完整 的 系统 测 
试 和 用 户 验 收 测试 ， 在 生产 环境 上 线 时 也 没有 发 现任 何 缺陷 。 系 统 测 
试 时 发 现 了 几 个 核心 计算 组 件 以 外 的 错误 。 业 务 人 员 之 所 以 觉得 用 户 
验收 测试 非常 好 ， 是 因为 出 现 计算 错误 时 ， 我 们 都 非常 确定 根本 问题 
是 在 计算 代码 的 上 游 。 使 用 了 FitNesse 后 ， 很 容易 诊断 出 缺陷 的 根 
源 ， 从 而 可 以 更 加 利落 快速 地 交付 到 生产 环境 中 。>” 

科罗拉多 州 丹 佛 市 的 惠 好 公司 有 个 软件 开发 团队 ， 他 们 编写 并 维 
护 一 些 工 程 应 用 和 木 制 框 染 的 计算 引擎 。 在 使 用 实例 化 需求 说 明 以 
前 ， 结 构 工程 师 通常 不 会 参与 到 软件 开发 过 程 中 ， 即 使 团队 正在 处 理 
一 些 复杂 的 科学 计算 公式 和 规则 。 这 导致 了 一 些 质量 问题 和 延误 ， 由 
于 使 用 这 个 引擎 的 应 用 程序 有 好 几 个 ， 计 算 过 程 变 得 更 加 复杂 。 项 目 
的 软件 质量 保证 主管 Pierre Veragen 认 为 发 布 前 的 艰难 时 期 会 拖累 项 
目 ， 版 本 发 布 出 去 后 很 少 会 没 问 题 。 

实施 实例 化 需求 说 明 后 ， 团 队 现在 和 结构 工程 师 合 作 制定 需求 说 
明 ， 并 自动 化 验证 结果 。 当 有 变更 需求 进来 时 ， 测 试 人 员 和 结构 工程 
师 一 起 得 出 期 望 的 计算 结果 ， 并 在 开发 开始 前 用 实例 把 结果 记录 在 需 
求 说 明 中 。 之 后 批准 变更 的 工程 师 会 编写 需求 说 明和 测试 。 

Veragen 说 新 方法 的 主要 好 处 是 他 们 在 做 改动 时 有 信心 了 。 到 2010 
年 初 ， 他 们 的 活 文档 系统 中 已 经 有 超过 30000 个 检查 ， 而 且 几 年 内 都 没 


有 发 现 大 的 缺陷 ， 现 在 已 经 停止 追踪 缺陷 了 。Veragen 指 出 : 

“我 们 不 需要 RBM) 这 个 指标 了 ， 因 为 我 们 知道 它 不 会 再 回来 
了 .….… 工 程 师 们 喜欢 测试 先行 的 方式 ， 并 且 能 直接 访问 自动 化 测试 。>” 

Lance Walton 参 与 过 一 家 大 型 法 国 银行 伦敦 分 行 的 信用 风险 管理 
程序 的 开发 。 项 目 刚 开始 的 时 候 ， 有 外 来 的 顾问 帮助 团队 采用 极限 编 
程 的 实践 ， 但 是 他 们 没有 采用 任何 实例 化 需求 说 明 的 做 法 《虽然 极限 
编程 包括 客户 测试 ， 这 个 与 可 执行 的 需求 说 明 很 接近 ) 。6 个 月 后 ， 
Walton 加 入 了 这 个 项 目 ， 他 发 现代 码 质量 很 低 。 虽 然 团队 每 两 个 星期 
都 会 有 交付 ， 但 是 写 出 来 的 代码 使 验证 变 得 很 复杂 。 开 发 人 员 只 测试 
最 近 实 现 的 功能 ， 随 着 系统 的 增长 ， 这 样 的 做 法 就 不 够 了 。“ 当 有 版 本 
发 布 时 ， 大 家 都 紧张 地 围 坐 着 ， 想 确保 所 有 功能 都 能 正常 运行 ， 并 且 
期 望 可 以 在 几 个 小 时 内 发 现 一 些 问题 。”Walton 如 此 说 。 在 实施 实例 化 
需求 说 明 后 ， 产 品 的 质量 和 人 员 的 信心 都 有 了 显著 的 提高 。 他 补充 
道 : 

“我 们 十 分 确信 我 们 发 布 的 版 本 没有 问题 。 我 们 高 兴 地 部 署 完 以 后 
就 出 去 享受 午餐 了 ， 不 用 再 担心 是 否 会 出 问题 。” 

与 此 形成 鲜明 对 比 的 是 ， 英 国贸 易 者 传媒 (Trader Media) 集 团 的 网 
站 重 写 项 目 停止 使 用 实例 化 需求 说 明 后 ， 却 遭遇 了 质量 问题 。 起 初 团 
队 协 作 完 成 需求 说 明和 自动 化 验证 。 在 管理 层 的 压力 下 ， 他 们 为 了 更 
早 更 快 地 交付 更 多 的 功能 而 没有 继续 下 去 。 测 试 团队 的 主管 Stuart 
Taylor 说 :“ 我 们 注意 到 质量 出 现 了 大 幅 下 滑 .…… 以 前 我 们 (测试 人 
Fa) 很 难 找到 缺陷 ， 而 后 来 我 们 却 发 现 一 个 用 户 故 事 会 有 四 五 个 缺 
陷 。” 

并 不 局 限于 敏捷 团队 

不 是 只 有 敏捷 团队 才 可 以 从 协作 制定 需求 说 明 中 获 益 。 在 
Bridging the Communication Gap 一 书 中 ， 我 建议 在 更 为 传统 的 结构 
过 程 中 应 用 类 似 的 实践 。 在 那 本 书 出 版 后 ， 我 在 为 本 书 做 调研 时 正好 
碰 到 一 家 公司 这 么 做 了 。 


英国 Sopra 集 团 的 高 级 测试 顾问 Matthew Steer 帮 助 一 个 大 型 电信 
公司 的 第 三 方 离 岸 软件 交付 伙伴 实现 了 这 些 实践 。 他 们 意识 到 项 目 需 
求 定 义 不 明 确 后 ， 决 定 作 出 改变 。Steer 比 较 了 实施 实例 化 需求 说 明 前 
后 一 年 的 交付 成 本 。 不 出 意料 ， 这 些 项 目 使 用 瀑布 方式 开发 ， 没 能 达 
到 零 缺 陷 的 级 别 ， 但 是 这 些 改变 “提高 了 上 游 缺 陷 的 发 现 率 ,减少 了 下 
游 的 返工 和 成 本 ”。 Steer 说 : 

“我 们 在 软件 生命 周期 早期 发 现 的 很 多 缺陷 ， 传 统 上 要 到 晚期 才能 
发 现 ， 这 足以 证 明 这 个 方法 行 之 有 效 。 缺 陷 数 在 生命 周期 的 晚期 有 了 明 
显 的 下 降 ， 而 在 早期 则 有 所 提升 。>” 

最 后 结果 是 ， 交 付 成 本 仅 在 2007 年 就 节省 了 170 万 英镑 。 


1.3 减少 返工 


一 般 来 讲 ， 频 繁 地 发 布 会 促进 快速 反馈 ， 使 得 开发 团队 能 够 更 快 
地 发 现 错误 、 修 复 错 误 。 但 是 快速 迭代 并 不 能 避免 错误 。 通 常情 况 
下 ， 团 队 实现 一 个 功能 时 会 有 三 四 次 反复 。 开 发 人 员 称 ， 这 是 因为 客 
户 在 拿 到 产品 试用 前 并 不 知道 自己 想 要 什么 。 我 并 不 这 么 认为 。 使 用 
实例 化 需求 说 明 后 ， 通 常 团队 第 一 次 实现 的 就 是 客户 所 要 的 ， 无 需 返 
工 。 这 可 以 节省 大 量 的 时 间 ， 并 使 得 交付 流程 更 具 可 预测 性 、 更 加 可 
Eo 

位 于 伦敦 的 英国 天 空 广播 公司 (British Sky Broadcasting) HAZ MX 
络 服务 (SNS) 部 门 负责 宽带 和 电话 的 服务 配置 (provisioning) 软 件 ， 它 的 
业务 流程 和 系统 集成 都 极为 复杂 。 访 部门 由 6 个 团队 组 成 ， 他 们 使 用 实 
例 化 需求 说 明 已 经 有 好 几 年 了 。 据 他 们 的 资深 敏捷 Java 程 序 员 Rakesh 
Patel 说 :“ 当 我 们 说 交付 时 ， 确 实 是 能 马上 交付 的 。” 并 且 该 部 门 在 Sky 
公司 内 具有 很 高 的 声望 。Patel 曾 和 其 他 公司 的 团队 一 起 工作 了 一 段 短 
暂 的 时 间 ， 他 对 两 个 团队 做 了 比较 ， 他 说 : 

“他 们 (其 他 公司 的 程序 员 ) 每 次 在 迭代 (sprint) 快 要 结束 的 时 候 
才 把 软件 交 给 测试 人 员 ， 测 试 人 员 总 是 发 现 问题 并 退回 给 程序 员 。 而 
在 这 里 (Sky) ， 我 们 不 会 如 此 反复 。 如 果 有 错误 ， 我 们 会 编写 一 个 测 


试 ， 而 后 在 开发 过 程 中 使 测试 变 绿 一 一 要 么 通过 ， 要 么 不 过 。 我 们 可 
以 当场 发 现 问题 。” 

其 他 不 少 团 队 注意 到 了 返工 的 大 量 减少 ， 其 中 包含 LeanDog, 它 
为 一 家 美国 大 型 保险 机 构 开 发 聚合 应 用 软件 。 他 们 的 应 用 软件 为 很 多 
大 型 主机 和 基于 Web 的 服务 提供 统一 的 用 户 界 面 ， 而 且 由 于 拥有 来 自 
全 国 各 地 的 大 量 项 目 干系 人 ， 该 软件 变 得 更 加 复杂 。 最 初 ， 在 需求 方 
面 ， 该 项 目 遭 受 了 很 多 功能 缺失 的 问题 。Rob Park 是 LeanDog 里 帮助 团 
队 转 型 的 敏捷 教练 ， 他 说 : 

“ 刚 开始 理 清 头绪 时 ， 我 们 需要 澄清 需求 ， 而 后 我 们 发 现 不 得 不 切 
实 做 些 改变 。” 

该 团队 实施 了 实例 化 需求 说 明 ， 结 果 需 求 说 明 改 善 了 ， 返 工 也 减 
少 了 。 气 Park 说 ， 虽 然 当 程序 员 针对 某 个 故事 卡 开展 工作 时 ， 有 些 问 
题 还 要 向 业务 分 析 师 咨询 ， 但 是 “问题 已 经 大 为 减少 ， 而 且 重 复 性 工作 
少 了 ， 只 剩 下 不 同 的 问题 ”。 对 他 来 说 ， 实 例 化 需求 说 明 最 有 价值 的 方 
面 在 于 “ 当 着 手 实现 一 个 故事 时 ， 你 可 以 领会 它 的 意图 ， 并 了 解 它 的 范 
围 。” 

很 多 团队 还 发 现在 开发 周期 的 起 始 阶段 ， 使 用 实例 化 需求 说 明 会 
让 需求 更 加 精确 ， 这 样 管理 产品 功能 清单 (product backlog) 会 更 加 容 
易 。 例 如 ， 能 够 尽早 识别 太 含 糊 或 有 太 多 功能 缺失 的 故事 ， 这 样 可 以 
防止 以 后 出 现 问题 。 如 果 疫 有 实例 化 需求 说 明 ， 团 队 经 党 要 到 迭代 中 
期 才 发 现 问题 ， 这 会 中 断 流程 而 且 需 要 耗费 时 间 重 新 讨论 一 一 在 大 公 
司 ， 决 定 功 能 范围 的 项 目 干 系 人 往往 无 法 轻易 预约 到 。 

实例 化 需求 说 明 能 帮助 团队 建立 一 个 协作 制定 需求 的 过 程 ， 这 可 
以 减少 兴 代 中 期 的 问题 。 此 外 ， 实 例 化 需求 说 明 适 用 于 短 迭 代 ， 并 且 
不 需要 花费 数 月 的 时 间 来 编写 见长 的 文档 。 

Ultimate 软件 公司 位 于 佛罗里达 州 的 韦 斯 顿 ， 对 于 它 的 全 球 智 能 管 
理 (Global Talent Management) 团 队 来 说 ， 减 少 返 工 是 一 个 主要 的 优 
点 。 协 作 制 定 需求 说 明 在 专注 开发 工作 方面 有 着 显著 的 影响 。 据 
Ultimate 软 件 公 司 的 资深 测试 开发 工程 师 Scott Berger 所 述 : 


“在 团队 认可 一 个 故事 之 前 ， 与 产品 负责 人 一 起 审核 测试 场景 可 以 
使 工作 小 组 (产品 负责 人 、 开 发 人 员 和 测试 人 员 ) 澄清 模棱两可 或 缺 
失 的 需求 。 有 时 ， 会 议 结果 甚至 会 把 故事 给 撤销 了 ， 例如， 测试 场景 
会 揭露 出 系统 隐藏 的 复杂 性 或 相互 矛盾 的 需求 。 有 一 次 ， 进 行 这 样 的 
讨论 之 后 ， 大 家 做 出 的 决定 是 几乎 重新 设计 整个 功能 ! 产品 负责 人 获 
得 了 重 写 和 重新 分 割 需 求 的 机 会 ， 而 不 是 在 开发 进行 之 后 ， 中 途 停止 
或 取消 该 故事 。 通 过 举行 这 些 会 议 ， 我 们 发 现 自己 的 生产 力 和 效率 都 
提高 了 ， 因 为 减少 了 浪费 ， 而 且 模 糊 和 需求 缺失 的 程度 降 到 了 最 低 。 
同时 还 让 团队 对 预期 达成 了 共识 。” 

大 多 数 团队 显著 地 减少 或 完全 消除 了 由 于 误解 需求 或 忽视 客户 的 
期 望 而 造 成 的 返工 。 本 书 所 描述 的 实践 ， 可 以 让 团队 更 好 地 与 商业 用 
户 打 交道 ， 并 确保 大 家 对 结果 达成 共识 。 


1.4 更 好 的 协作 


实例 化 需求 说 明 的 另 一 个 重要 好 处 是 能 够 使 得 不 同 的 软件 开发 活 
动 在 短 迭 代 周 期 里 更 好 地 协作 。 根 据 我 的 经 验 和 本 书 中 的 案例 研究 ， 
对 很 多 团队 来 说 ， 采 用 Scrum 最 大 的 绊脚石 就 是 无 法 彻底 完成 迭代 里 
的 任务 。 很 多 团队 还 坚持 “ 老 旧 的 ”理念 : 先 完成 开发 ， 然 后 完成 测 
试 ， 最 终 修饰 润色 后 发 布 。 这 会 滋生 一 种 错觉 ， 以 为 开发 是 分 阶段 完 
成 的 ;而 事实 上 ， 开 发 的 完成 是 需要 后 续 的 测试 和 修复 的 。 在 Scrum 
进度 板 上 , “done” 列 代表 开发 人 员 觉 得 有 些 事情 已 经 完成 , “done- 
done” 列 意味 着 测试 人 员 赞 同 任务 已 经 完成 ， 等 等 之 类 (甚至 有 人 说 他 
们 采用 了 “done-done-done” 列 ) 。 我 们 的 工作 往往 会 落 入 这 种 模式 ， 同 
时 测试 的 结果 影响 到 下 一 个 周期 ， 这 会 造成 很 大 的 变数 并 使 得 交付 过 
程 变 得 更 难 预测 。 

实例 化 需求 说 明 解 决 了 这 个 问题 。 本 书 所 介绍 的 实践 让 团队 清晰 
地 定义 一 个 可 以 普遍 理解 和 客观 衡量 的 目标 。 因 此 ， 很 多 团队 发 现 他 
们 的 分 析 、 开 发 和 测试 活动 变 得 可 以 更 好 地 协作 了 。 


uSwitch 是 一 个 成 功 改善 协作 的 例子 一 它 是 英国 最 繁忙 的 网 站 中 
的 一 个 。 从 前 ，uSwitch 很 难 知道 某 个 功能 何 时 可 以 完成 ， 因 此 他 们 在 
2008 年 实施 了 实例 化 需求 说 明 。 该 网 站 的 一 位 开发 人 员 Stephen Lloyd 
说 :“ 过 去 ， 我 们 将 完成 的 工作 交 给 QA 部 门 ， 而 他 们 很 快 会 告诉 说 我 
们 筷 记 了 测试 某 个 场景 ， 这 给 我 们 造成 了 很 多 问题 。 ”通过 实施 实例 化 
需求 说 明 ， 他 们 克服 了 这 个 问题 。Lloyd 说 他 们 现在 更 好 地 整合 成 了 一 
个 团队 ， 并 且 对 业务 需求 有 了 更 好 的 理解 。 过 程 的 改变 还 提高 了 软件 
的 质量 。 该 网 站 的 另 一 名 开发 人 员 Hemal Kuntawala 则 这 么 说 : 

“我 们 整个 网 站 的 错误 率 显 著 地 下 降 了 ， 修 复 问题 也 比 以 前 快 很 
多 。 如 果 在 线 的 网 站 确实 出 现 了 问题 ， 我 们 通常 能 够 在 几 个 小 时 内 修 
复 ， 而 此 前 需要 几 天 甚至 几 周 。” 

Beazley 是 一 家 专业 保险 公司 ， 他 们 的 团队 也 经 历 了 协作 改善 的 过 
程 。 他 们 在 美国 的 业务 分 析 师 和 在 英国 的 开发 人 员 、 测 试 人 员 一 起 工 
作 。 他 们 实施 实例 化 需求 说 明 主 要 是 为 了 确保 软件 能 够 在 迭代 结束 时 
完成 。Ian Cooper 是 Beazley 一 个 开发 团队 的 队长 ， 他 说 : 

“我 们 一 直 都 写 单元 测试 ， 但 问题 是 当中 有 一 条 鸿沟 一 一 这 些 测试 
可 以 告诉 我 们 软件 是 否 工 作 ， 却 没有 告诉 我 们 它 是 否 是 客户 所 需 的 。 
过 去 我 们 甚至 没有 让 测试 人 员 在 (开发 的 ) 同一 个 周期 内 进行 测试 。 
他 们 (测试 人 员 ) 会 把 前 一 轮 迭 代 的 信息 反馈 到 当前 的 迭代 里 。 不 过 
现在 已 经 没有 这 种 情况 了 。 我 们 对 验收 有 了 更 清晰 的 认识 。>” 

AdScale.de 是 一 个 在 线 广告 市 场 ， 他 们 在 新 西 兰 的 团队 有 类 似 的 
经 历 。 在 项 目 启动 两 年 之 后 ， 日 益 复 杂 的 用 户 界 面 和 系统 集成 使 得 代 
码 库 变 得 非常 大 ， 仅 仅 使 用 单元 测试 已 经 无 法 有 效 地 进行 管理 。 开 发 
人 员 认 为 事情 已 经 完成 了 ， 于 是 继续 去 做 其 他 事情 ， 然 而 在 测试 人 员 
评审 后 ， 开 发 人 员 却 不 得 不 进行 返工 。 因 为 测试 和 开发 之 间 的 脱节 ， 
找到 问题 所 在 需要 人 花费 很 长 的 时 间 。 前 面 几 轮 迭代 的 问题 影响 了 后 面 
的 迭代 ， 扰 乱 了 开发 的 流程 。 在 实施 实例 化 需求 说 明 后 ， 开 发 和 测试 
的 协作 更 紧密 了 。Clare McLennan 是 这 个 项 目的 开发 /测试 人 员 ， 她 
说 : 


“即时 反馈 减少 了 发 布 过 程 的 很 多 压力 。 以 前 ， 开 发 人 员 对 我 们 感 
到 泪 形 ， 因 为 他 们 的 功能 无 法 发 布 。 同 时 我 们 也 对 他 们 很 无 语 ， 因 为 
他 们 没有 修复 问题 ， 导 致 我 们 无 法 测试 他 们 的 功能 。 我 们 在 等 他 们 而 
他 们 也 在 等 我 们 。 现 在 这 个 问题 已 经 不 存在 了 ， 因 为 全 部 测试 一 次 只 
需 一 个 小 时 。 前 一 轮 和 迭代 完成 的 功能 不 会 被 退回 而 放 到 下 一 轮 和 迭代 
里 。 a 

实例 化 需求 说 明 使 得 团队 可 以 用 一 种 清晰 、 客 观 和 可 衡量 的 方式 
定义 预期 的 功能 。 它 还 能 加 速 反 馈 、 改 善 开发 流程 ， 并 防止 中 断 计 划 
好 的 工作 。 


1.5 铭记 
正确 地 构建 产品 和 构建 正确 的 产品 是 两 回 事 。 二 者 兼顾 才能 取得 
成 功 。 


实例 化 需求 说 明 能 够 在 适当 的 时 间 提 供 恰 好 够 用 的 文档 ， 帮 助 使 
用 短 迭 代 或 基于 流 的 开发 过 程 构建 正确 的 产品 。 

实例 化 需求 说 明 有 助 于 提高 软件 产品 的 质量 ， 显 著 减少 返工 ， 并 
使 得 团队 更 好 地 在 分 析 、 开 发 和 测试 活动 中 进行 协作 。 

从 长 远 来 看 ， 实 例 化 需求 说 明 有 助 于 团队 创建 一 个 活 文 档 系 统 ， 
它 是 一 种 具有 相关 性 的 、 可 靠 的 功能 描述 ， 会 随 着 程序 代码 的 变更 自 
动 更 新 。 

实例 化 需求 说 明 的 实践 配合 短 迭代 (Scrum、 极 限 编程 或 基于 流 的 
开发 方法 (看 板 ) 一 起 使 用 ， 效 果 最 好 。 有 些 思想 也 适用 于 结构 化 开 
发 过 程 [统一 软件 过 程 (RUP)、 瀑 布 过 程 ]， 而 且 已 经 有 一 些 案例 表明 ， 
有 公司 因此 节省 了 上 百 万 经 费 。 


第 2 章 关键 过 程 模式 


实例 化 需求 说 明 是 一 组 过 程 模式 ， 它 可 以 协助 软件 产品 的 变更 ， 
确保 正确 的 产品 能 够 有 效 地 交付 。 在 为 本 书 做 调研 的 过 程 中 ， 我 采访 


了 很 多 团队 ， 图 2-1 展 示 了 那些 最 成 功 的 团队 普遍 采用 的 一 些 天 键 模 
式 ， 以 及 这 些 模式 之 间 的 关系 。 这 些 团 队 大 多 是 在 寻找 更 高 效 的 方法 
去 构建 和 维护 软件 的 过 程 中 ， 通 过 反复 的 试验 和 摸索 实现 了 新 的 过 程 
思想 。 我 希望 ， 通 过 揭示 他 们 过 程 中 的 模式 ， 能 够 帮助 其 他 团队 从 容 
地 实施 这 些 想法 。 
为 什么 需要 模式 

本 书 提 到 的 过 程 思想 形成 了 一 些 模式 ， 也 就 是 说 ， 它 们 是 可 以 再 
现 的 ， 可 以 为 不 同 的 团队 所 使 用 ; 我 说 的 不 是 克里斯托弗 ? 亚历山大 
(著名 建筑 师 ) 对 模式 的 定义 。 我 所 说 的 过 程 思想 ， 可 以 出 现在 不 同 
的 背景 中 ， 但 它们 会 产生 类 似 的 结果 。 我 并 没有 像 更 为 传统 的 模式 书 
籍 那样 ， 记 录 模 式 是 如 何 创建 的 ， 以 及 它 会 带 来 什么 样 的 影响 。 敏 捷 
联盟 功能 测试 工具 (Agile Alliance Functional Testing Tools) 讨 论 组 组 织 
了 多 次 模式 编写 的 工作 坊 ， 想 以 一 种 更 加 传统 的 方式 去 记录 并 建立 一 
个 模式 目录 ， 他 们 做 这 项 工作 的 部 分 原因 正 是 由 于 本 书 的 案例 所 取得 
的 成 果 ， 但 是 完成 这 项 工作 尚 须 时 日 。 我 决定 暂 不 把 模式 扩展 成 为 更 
传统 的 格式 ， 这 项 工作 留待 本 书 的 后 续 版 本 去 完成 。 

在 Bridging the Communication Gap 一 书 中 ， 我 主要 关注 的 是 实例 
化 需求 说 明 的 实际 产 出 ， 例 如 需求 说 明和 验收 测试 ， 忽 视 了 团队 在 各 
种 不 同情 况 下 ， 可 能 需要 完全 不 同 的 方法 来 获取 同样 的 工件 。 在 本 书 
中 ， 我 关注 于 过 程 模 式 、 如 何 创建 工件 以 及 它们 在 流程 中 如 何 对 后 续 
的 工件 作出 贡献 等 方面 。 

即时 (Just-in-time) 

如 图 2-1 所 示 ， 成 功 的 团队 不 会 一 次 性 或 针对 所 有 需求 实现 整个 系 
列 的 工作 ， 尤 其 不 会 在 开发 启动 前 实现 。 相 反 ， 当 团队 准备 好 接受 更 
多 的 工作 时 ， 例 如 在 项 目 开发 阶段 或 里 程 碑 的 一 开始 ， 他 们 会 从 目标 
中 获取 范围 。 只 有 当 团 队 准备 开始 实现 某 个 功能 时 ， 比 如 在 相关 和 迭代 
的 开始 ， 他 们 才 着 手 制 定 需 求 说 明 。 不 要 误 认 为 图 2-1 中 的 系列 步骤 是 
大 型 的 瀑布 式 需 求 说 明 。 


实例 化 需求 说 明 的 关键 过 程 模式 


从 目标 中 获取 范围 (用 户 故 事 ， 用 例 ) 


实例 化 


需求 说 明 协作 制定 
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图 2-1 实例 化 需求 说 明 的 主要 过 程 模式 


本 章 中 ， 我 对 关键 过 程 模式 提出 了 一 个 简要 的 概述 。 然 后 我 们 将 
在 第 二 部 分 仔细 讨论 实施 这 些 模式 的 思想 和 主要 挑战 。 
2.1 示 > 

实现 范围 (Implementation scope) 含 有 对 业务 问题 的 解决 方案 或 达成 
业务 目标 的 手段 。 很 多 团队 在 开始 实现 软件 之 前 (在 此 之 前 发 生 的 一 
切 往往 被 软件 开发 团队 所 忽略 ) ， 期 望 客户 、 产 品 负责 人 或 商业 用 户 
来 确定 工作 的 范围 。 在 商业 用 户 明 确 说 明 他 们 的 需求 后 ， 软 件 交 付 团 


队 就 依 此 实现 。 这 样本 应 该 会 让 客户 感到 满意 。 但 事实 上 ， 这 正 是 构 
建 产 品 开始 出 现 问题 的 时 候 。 

如 果 软 件 交 付 团 队 依赖 客户 给 出 用 户 故 事 、 用 例 清单 或 其 他 相关 
言 息 ， 那 么 他 们 其 实 是 在 让 客户 设计 解决 方案 。 但 是 商业 用 户 不 是 软 
件 设计 师 。 如 果 我 们 让 客户 去 界定 范围 ， 那 么 项 目 就 无 法 从 交付 团队 
已 有 的 知识 中 受益 。 这 样 开 发 出 来 的 软件 是 客户 所 要 求 的 ， 却 不 是 他 
们 真正 想 要 的 。 

成 功 的 团队 不 会 盲目 地 接受 软件 需求 ， 将 其 作为 未 知 问题 的 解决 
方案 ， 相 反 ， 他 们 会 从 目标 中 获取 范围 。 他 们 以 客户 的 业务 目标 为 起 
始 ， 然 后 通过 协作 界定 可 以 实现 目标 的 范围 。 团 队 与 商业 用 户 一 起 工 
作 确 定 解决 方案 。 商 业 用 户 专 注 于 传达 所 需 功 能 希望 达到 的 目的 ， 以 
及 他 们 期 望 由 此 市 来 的 价值 ， 这 样 有 助 于 所 有 人 了 解 所 需 的 功能 。 然 
后 团队 提议 一 个 解决 方案 ， 这 要 比 商 业 用 户 自 己 想 出 来 的 方案 更 实 
惠 、 更 快 ， 并 且 更 容易 交付 或 维护 。 


注释 : WW 关于 一 些 好 的 例子 ， 请 看 
http://gojko.net/2009/12/10/challenging-requirementso 


2.2 | KÌ 


在 设计 需求 阶段 ， 如 果 开 发 人 员 和 测试 人 员 都 没有 参与 ， 那 么 我 
们 就 必须 单独 将 这 些 需求 传达 给 他 们 。 在 实践 中 ， 这 很 容易 造成 一 些 
误解 ， 在 需求 传递 的 过 程 中 会 丢失 很 多 细节 。 结 果 是 ， 丙 业 用 户 不 得 
不 在 软件 交付 后 进行 验证 ， 而 如 果 验 证 失败 ， 那 么 团队 必须 回去 修改 
软件 。 这 些 都 是 不 必要 的 返工 。 

成 功 的 团队 不 会 依赖 于 某 个 人 独自 去 收集 正确 的 需求 ， 而 是 会 
商业 用 户 一 起 协作 制定 解决 方案 。 不 同 背 景 的 人 们 拥有 不 同 的 想法 ， 
他 们 会 凭借 自己 的 经 验 来 解决 问题 。 技 术 专家 知道 如 何 更 好 地 使 用 底 
层 的 基础 架构 ， 或 者 如 何 应 用 新 兴 的 技术 。 测 试 人 员 知道 从 哪里 寻找 


潜在 的 问题 ， 而 团队 则 应 该 去 做 防止 出 现 这 些 问 题 的 事情 。 在 设计 需 
求 时 需要 捕获 所 有 这 些 信息 。 

协作 制定 需求 说 明 使 我 们 能 够 充分 利用 整个 团队 的 知识 和 经 验 。 
它 还 创造 了 需求 的 集体 所 有 制 ， 让 每 个 人 能 更 多 地 参与 到 交付 过 程 
中 。 


2.3 举例 说 明 


自然 语言 是 模棱两可 的 ， 而 且 和 上 下 文 相关 。 仅 仅 使 用 此 类 语言 
编写 的 需求 ， 无 法 为 开发 或 测试 提供 一 个 完整 明确 的 上 下 文 。 开 发 人 
员 和 测试 人 员 在 开发 软件 及 编 瑟 测试 脚本 的 时 候 ， 必 须 对 需求 进行 解 
释 ， 而 不 同 的 人 可 能 会 对 一 些 来 手 的 概念 有 着 截然 不 同 的 解释 。 

有 些 事情 看 起 来 简单 易 懂 ， 但 事实 上 想 要 完全 理解 它们 ， 要 有 领 
域 的 专业 知识 或 者 专业 术语 的 知识 才 行 ， 这 时 尤其 容易 引发 一 些 问 
题 。 理 解 上 的 细微 差别 会 有 一 个 累积 效应 ， 往 往 导致 交付 后 需要 返 
工 。 这 会 导致 不 必要 的 延误 。 

在 首次 使 用 编程 语言 实现 需求 的 过 程 中 ， 成 功 的 团队 不 会 等 待 需 
求 被 精确 表述 ， 而 会 举例 说 明 需 求 。 团 队 与 商业 用 己 一 起 工作 ,确定 
出 那些 描述 预期 功能 的 关键 实例 。 在 此 过 程 中 ， 开 发 人 员 和 测试 人 员 
往往 会 提出 一 些 额 外 的 实例 ， 用 于 说 明 边界 情况 ， 或 重点 标识 出 系统 
中 某 些 特别 有 问题 的 地 方 。 这 可 以 清除 功能 分 歧 和 不 一 致 的 地 方 ， 并 
确保 所 有 参与 者 都 对 需要 交付 的 东西 有 一 个 共识 ， 避 免 由 误解 及 解释 
到 位 导致 的 返工 。 

如 果 系 统 能 按照 所 有 关键 实例 那样 工作 ， 那 么 它 就 是 大 家 都 认同 
的 。 需 求 说 明 的 关键 实例 有 效 地 定义 了 软件 需要 做 什么 。 它 们 不 仅仅 
是 开发 的 目标 ， 还 是 检查 开发 是 否 完成 的 客观 评价 标准 。 

如 果 关键 实例 容易 理解 和 沟通 ， 就 可 以 被 有 效用 作 清 晰 和 详细 的 


协作 过 程 中 的 开放 讨论 可 以 建立 大 家 对 相关 领域 的 共识 ， 但 是 最 
终 得 到 的 实例 往往 包含 很 多 不 必要 的 细节 。 例 如 ， 商 业 用 户 会 从 用 己 
界面 的 角度 考虑 问题 ， 所 以 他 们 提供 的 实例 是 关于 点 击 链接 和 填充 字 
段 时 系统 应 如 何 工 作 的 。 如 此 详细 的 描述 会 约束 系统 : 详细 描述 如 何 
实现 某 个 功能 ， 而 不 去 描述 需要 什么 功能 ， 这 是 一 种 瀛 费 行为 。 过 多 
的 细节 会 让 实例 更 难 沟通 和 理解 。 

天 键 实 例 必 须 精简 才 有 用 。 通 过 提炼 需求 说 明 ， 成 功 的 团队 能 够 
移 除 多 余 的 信息 并 为 开发 和 测试 创建 一 个 具体 的 、 精 确 的 上 下 文 。 他 
们 以 适量 的 细节 来 定义 目标 ， 以 便 实 现 和 验证 。 他 们 应 明确 软件 该 做 
什么 ， 而 不 是 软件 该 如 何 工作 。 

提炼 好 的 实例 可 以 当 作 交付 的 验收 条 件 。 只 有 当 所 有 实例 在 系统 
中 都 可 以 正常 工作 时 ， 开 发 才 算 完成 。 为 了 让 关键 实例 更 容易 理解 ， 
团队 要 提供 一 些 额外 信息 ， 此 时 ， 实 际 上 团队 就 已 经 创建 出 了 带 实 例 
的 需求 ， 它 是 一 种 工作 规范 和 验收 测试 ， 也 可 用 作 将 来 的 功能 回归 测 
itto 


2.5 HF 证 时 不 修 


一 旦 团队 对 市 实例 的 需求 达成 一 致 并 且 对 其 进行 了 提炼 ， 那 么 团 
队 就 可 以 将 它们 当 作 要 实现 的 目标 以 及 验证 产品 的 手段 。 在 开发 过 程 
中 ， 这 些 测试 将 对 系统 进行 多 次 验证 ， 以 确保 它 符合 目标 。 人 工 运行 
这 些 检查 会 产生 不 必要 的 延误 ， 并 且 反 馈 也 会 较 慢 。 

快速 反馈 是 短 迭 代 或 流程 模式 软件 开发 中 一 个 必 不 可 少 的 元 素 ， 
所 以 我 们 要 把 验证 系统 的 流程 变 得 廉价 而 且 高 效 。 一 个 显而易见 的 解 
决 方案 就 是 自动 化 。 但 是 在 概念 上 ， 这 种 自动 化 与 通常 意义 上 的 开发 
或 测试 目 动 化 有 所 不 同 。 

如 果 我 们 使 用 传统 的 编程 (单元) 自动 化 工具 或 传统 的 功能 测试 
自动 化 工具 来 实现 天 键 实 例 验证 的 自动 化 ， 那 么 当 业 务 需求 和 技术 自 
动 化 之 间 委 失 细 节 时 ， 有 可 能 会 引入 问题 。 商 业 用 户 终究 无 法 获取 技 
术 上 的 自动 化 需求 说 明 。 当 需求 改变 时 〈 是 当 ， 不 是 如 果 ) ， 或 者 当 


开发 人 员 或 测试 人 员 需 要 获取 进一步 澄清 时 ， 我 们 将 无 法 再 使 用 之 前 
自动 化 的 需求 说 明 。 我 们 可 以 同时 用 两 种 形式 来 保留 关键 实例 : 一 种 
是 测试 ， 另 一 种 是 可 读 性 更 强 的 形式 ， 如 Word 文 档 或 网 页 。 但 只 要 存 
在 多 种 版 本 ， 我 们 就 会 有 同步 的 问题 。 这 就 是 为 什么 纸 质 文档 永远 不 
是 理想 选择 的 原因 。 

为 了 从 关键 实例 中 获得 最 大 的 收益 ， 成 功 的 团队 在 做 自动 化 验证 
时 不 会 去 改变 需求 信息 。 在 自动 化 过 程 中 ， 他 们 几乎 完全 不 改变 需 : 
说 明 一 一 这 样 就 不 会 有 错 译 的 风险 。 当 他 们 进行 自动 化 验证 而 不 改变 
需求 说 明 时 ， 关 键 实 例 看 起 来 与 他 们 写 在 白板 上 的 几乎 一 样 : 团队 的 
所 有 人 员 都 可 以 理解 、 可 以 访问 。 

团队 所 有 人 员 都 可 以 理解 、 访 问 的 自动 化 的 实例 化 需求 说 明 ， 变 
成 了 可 执行 的 需求 说 明 。 我 们 可 以 把 它 作 为 开发 的 目标 ， 同 时 可 以 轻 
松 地 检查 系统 是 否 按照 预期 运作 ， 而 且 我 们 可 以 使 用 同一 个 文档 获取 
商业 用 户 的 澄清 。 如 果 我 们 要 变更 需求 说 明 ， 只 要 在 一 个 地 方 变 更 即 
可 。 

如 果 你 从 未 见 过 用 于 自动 化 可 执行 需求 的 工具 ， 下 面 的 内 容 似乎 
会 令 人 难以 置信 ， 但 不 管 怎样 ， 请 看 图 2-2 和 图 2-3。 图 中 展示 了 两 个 
流行 的 工具 Concordion 和 FitNesse， 它 们 实现 了 完全 自动 化 的 可 执行 需 
求 。 
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e Free delivery is offered to a VIP customer with 10 books in the cart. 
e ltis not offered to a regular customer with 10 books 


e itis not offered to a VIP customer with only 9 books. 
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图 2-2 一 个 使 用 Concordion 来 自动 化 的 可 执行 需 3 


The prize pool is divided among the winners using the 
following distribution for winning combinations 
(number of correct hits out of six chosen numbers). 
Example below is for $2M payout pool. 


Prize Distribution for Payout Pool 2,000,000 
Winning Combination 
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图 2-3 一 个 使 用 FitNesse 来 自动 化 的 可 执行 需求 


还 有 其 他 许多 自动 化 框架 不 需要 对 关键 实例 进行 任何 翻译 。 本 书 
专注 于 成 功 团队 为 实施 实例 化 需求 说 明 所 采用 的 实践 ， 而 不 是 工具 。 
要 了 解 更 多 关于 工具 的 内 容 ， 请 访问 
http:/specificationbyexample.com， 你 可 以 在 那里 下 载 到 介绍 最 热门 工 
具 的 文章 。 同 时 ， 请 查阅 附录 里 建议 资源 列表 中 的 “工具 ”小 节 。 

测试 就 是 需求 说 明 ， 需 求 说 明 就 是 测试 

当 使 用 非常 具体 的 实例 描述 需求 说 明 时 ， 它 也 可 以 用 来 测试 系 
统 。 此 类 需求 说 明 在 自动 化 之 后 ， 就 变 成 了 一 种 可 执行 的 验收 测试 。 
因为 本 书 只 涉及 这 种 需求 说 明和 测试 ， 我 将 交替 使 用 需求 说 明和 测试 
这 两 个 词 。 在 本 书 里 ， 它 们 之 间 没 有 区 别 。 

这 并 不 意味 着 没有 其 他 类 型 的 测试 一 一 例如 ， 探 索性 测试 或 可 用 
性 测试 就 不 是 需求 说 明 。 上 下 文 驱动 测试 的 社区 试图 找 出 这 些 测试 类 
型 之 间 的 区 别 ， 通 过 使 用 背景 调查 来 区 别 哪些 是 可 以 被 自动 化 的 确定 
性 验证 ， 哪 些 是 需要 个 人 意见 和 专家 洞察 力 的 非 确定 性 验证 D 。 至 于 
上 下 文 驱 动 的 语言 ， 本 书 只 涉及 设计 和 自动 化 检查 。 通 过 实例 化 需求 
说 明 ， 可 以 让 测试 人 员 与 团队 其 他 成 员 一 起 协作 ， 利 用 专家 的 意见 和 
洞察 力 ， 设 计 出 好 的 检查 。 测 试 人 员 不 会 手动 执行 这 些 检查 ， 这 意味 
着 他 们 还 有 更 多 的 时 间 做 其 他 类 型 的 测试 。 


注释 : 请 看 www.developsense.com/blog/2009/08/testing-vs- 
checkingo 


2.0 SI 


为 了 有 效 地 支持 软件 系统 ， 我 们 需要 知道 它 在 做 什么 以 及 为 什么 
那么 做 。 在 许多 情况 下 ， 唯 一 的 办 法 是 深入 研究 程序 代码 或 者 找到 能 
帮 有 我 们 做 到 这 氮 的 人 。 代 码 往往 是 我 们 唯一 能 真正 信任 的 东西 ， 而 大 
多 数 编写 好 的 文档 在 项 目 交 付 前 就 已 经 过 时 了 。 程 序 员 是 知识 的 权威 
和 信息 的 瓶颈 。 


我 们 可 以 很 容易 地 针对 系统 验证 可 执行 的 需求 说 明 。 如 果 验 证 比 
较 频 繁 ， 那 么 我 们 融 可 以 像 信任 代码 那样 信任 可 执行 的 需求 说 明 。 

通过 频 每 地 检查 所 有 可 执行 的 需求 说 明 ， 团 队 能 快速 地 发 现 系 统 
和 需求 说 明之 间 的 任何 差别 。 因 为 可 执行 的 需求 说 明 很 容易 理解 ， 团 
队 可 以 和 商业 用 户 讨 论 这 些 改动 ， 并 决定 如 何 处 理 。 他 们 可 以 不 断 地 
同步 系统 和 可 执行 的 需求 说 明 。 


2.73 一 个 


RS 


最 成 功 的 团队 不 会 满足 于 一 些 频繁 验证 的 可 执行 的 需求 说 明 。 他 
们 能 确保 很 好 地 组 织 需 求 说 明 ， 让 大 家 很 容易 找到 和 获取 ， 并 让 它们 
保持 一 致 。 随 着 项 目的 发 展 ， 团 队 对 领域 的 理解 也 在 变化 。 市 场 机 遇 

影响 着 业务 领域 模型 。 能 从 实例 化 需求 说 明 中 获取 最 大 收益 的 团队 
会 更 新 他 们 的 需求 说 明 来 反映 这 些 变化 ， 演 化 出 活 文档 系统 。 

活 文档 是 天 于 系统 功能 可 靠 的 、 权 威 的 信息 源 ， 任 何人 都 可 以 获 
得 。 它 和 代码 一 样 可 靠 ， 但 是 更 容易 阅读 和 理解 。 支 持 人 员 可 以 用 它 
来 查 明 系统 在 做 什么 以 及 这 样 做 的 原因 。 开 发 人 员 可 以 用 它 作 为 开发 
的 目标 。 测 试 人 员 则 可 以 用 它 来 测试 。 分 析 功 能 变更 请 求 的 影响 时 ， 
业务 分 析 师 可 以 从 它 开 始 着 手 。 它 还 提供 了 免费 的 回归 测试 。 


2.8 实际 


在 本 书 的 其 余部 分 ， 我 会 专注 于 过 程 模式 而 不 是 过 程 的 工件 。 为 
了 更 深入 地 看 待 问 题 ， 人 确保 你 理解 这 些 术 语 ， 我 在 书 中 襄 括 了 一 个 例 
子 ， 用 来 说 明 整 个 过 程 产生 的 工件 ， 从 两 业 目标 到 活 文档 系统 。 例 子 
的 讨论 中 指明 了 我 会 在 哪些 章节 讨论 相关 内 容 。 

2.8.1 商业 目标 


商业 目标 是 项 目 或 项 目 里 程 碑 的 潜在 原因 。 它 是 帮助 商业 项 目 干 
系 人 (无 论 是 内 部 的 还 是 外 部 的 ) 决定 投资 软件 开发 的 指导 性 愿景 。 
商业 组 织 应 当 能 清晰 地 看 到 这 些 目标 如 何 赚 取 、 节 省 或 者 保护 财富 。 


把 “提高 对 现 有 客户 的 重复 销售 ”作为 商业 目标 ， 是 一 个 不 错 的 开始 。 
原则 上 ， 目 标 应 该 是 可 以 度量 的 ， 这 样 它 就 可 以 指导 实现 。 对 于 “12 个 
月 内 对 现 有 客户 提高 10% 的 重复 销售 * 和 “3 个 月 内 对 现 有 客户 提高 
500% 的 重复 销售 ”这 两 个 目标 ， 相 应 的 软件 范围 很 有 可 能 是 非常 不 同 
的 。 可 度量 的 目标 让 我 们 可 以 确定 项 目 成 败 、 跟 踩 进 度 和 更 好 地 排列 
优先 级 。 

良好 商业 目标 的 例子 

12 个 月 内 对 现 有 客户 提高 50% 的 重复 销售 。 

2.8.2 范围 

通过 应 用 我 在 第 5 章 会 讲 到 的 实践 ， 我 们 可 以 从 商业 目标 中 获取 实 
现 范 围 。 实 现 团队 和 商业 投资 者 一 起 提出 一 些 想法 ， 然 后 把 它们 分 成 
可 交付 的 软件 块 。 

比方 说 我 们 发 现 一 个 主题 故事 是 关于 客户 忠诚 度 计划 的 ， 这 个 故 
事 可 以 分 解 成 会 员 忠 诚 度 管理 系统 的 基本 功能 和 更 高 级 的 奖励 计划 。 
我 们 决定 首先 专注 在 建立 一 个 基本 的 会 员 忠 诚 度 管理 系统 上 : 客户 注 
册 一 个 VIP 计划 ，VIP 客 户 有 资格 获得 特定 物品 的 免费 送 货 。 我 们 将 推 
人 述 关 于 高 级 奖励 计划 的 讨论 。 下 面 是 这 个 例子 的 沁 围 。 

会 员 忠 诚 度 管理 系统 基本 功能 的 用 户 故事 

为 了 能 对 现 有 客户 做 产品 直销 ， 作 为 营销 经 理 ， 我 想 让 客户 通过 
加 入 VIP 计 划 注 册 个 人 信息 。 

为 了 吸引 现 有 客户 注册 VIP 计 划 ， 作 为 营销 经 理 ， 我 要 系统 为 VIP 
客户 提供 特定 物品 的 免费 送 货 。 

为 了 节省 开支 ， 作 为 现 有 客户 ， 我 希望 能 收 到 特价 优惠 的 信息 。 

2.8.3 关键 实例 

通过 应 用 第 6 章 和 第 7 章 所 讲述 的 实践 ， 一 旦 团队 开始 实现 某 个 特 
定 的 功能 ， 我 们 融 可 以 为 特定 的 泄 围 产生 具体 的 需求 说 明 。 比 如 ， 当 
我 们 开始 做 范围 中 的 第 二 项 一 一 免费 送 货 时 一 一 必须 定义 好 什么 是 免 
费 送 仙 。 在 协作 讨论 过 程 中 ， 为 了 避免 运送 电子 产品 和 大 件 物 品 相 关 


的 后 勤 问 题 ， 我 们 决定 系统 只 提供 书籍 的 免费 送 货 服务 。 因 为 商业 目 
标 是 提升 重复 销售 ， 我 们 尝试 让 客户 进行 2 多 次 购买 , “免费 送 货 ” 变 成 
了 “免费 为 5 本 或 以 上 书籍 送 货 ”。 我 们 要 确定 好 关键 实例 ， 比 如 VIP 客 
户 购买 5 本 图 书 、VIP 客 户 购买 5 本 以 下 的 图 书 ， 或 者 非 VIP 客 户 购 买书 
Fa 

接着 讨论 当 客 户 同时 购买 了 书籍 和 电子 产品 时 该 怎么 办 。 有 些 人 
建议 扩展 范围 ， 例 如 ， 将 订单 拆 分 成 两 个 ， 只 为 书籍 提供 免费 送 货 。 
我 们 决定 推迟 这 个 决定 ， 先 实现 最 简单 的 。 如 果 订 单 中 有 非 书籍 的 物 
品 ， 我 们 就 不 提供 免费 送 货 。 我 们 加 入 下 面 这 个 新 的 关键 实例 ， 之 后 
会 再 讨论 。 

关键 实例 : 免费 送 货 

VIP 客户 购物 车 中 有 5 本 书籍 可 以 获得 免费 送 货 。 

VIP 客户 购物 车 中 有 4 本 书籍 就 不 提供 免费 送 货 。 

普通 客户 购物 车 中 有 5 本 书籍 没有 免费 送 货 。 

VIP 客户 购物 车 中 有 5 人 台 洗衣 机 时 不 提供 免费 送 货 。 

VIP 客户 购物 车 中 有 5 本 书籍 和 1 台 洗 衣 机 时 不 提供 免费 送 货 。 


S 


2.8.4 > 


应 用 第 8 章 中 的 实践 ， 我 们 从 关键 实例 中 提炼 出 需求 说 明 、 创 建 出 
一 目 了 然 的 文档 并 将 其 格 9 式 化 成 便于 今后 做 自动 化 验证 的 格式 (如 下 
所 示 ) 。 

免费 送 货 

当 VIP 客 户 购 买 一 定数 量 的 书籍 时 ， 提 供 免费 送 货 。 免 费 送 货 不 
提供 给 普通 客户 或 购买 非 书籍 的 VIP 客户 。 

假定 至 少 买 5 本 书 才能 获得 免费 送 货 服务 ， 那 么 我 们 会 得 到 以 下 预 
期 : 

实例 


购物 车 中 的 物品 


VIP 5 台 洗 衣 机 | 标准 
VIP 5 本 书 ，1 台 洗衣 机 标准 


这 个 需求 说 明 一 -一目了然 的 文档 一 可 以 用 作 实现 的 目标 和 自 
动 化 测试 的 驱动 ， 这 样 我 们 就 可 以 客观 地 衡量 什么 时 候 算 完成 了 。 把 
它 作为 活 文档 的 一 部 分 ， 保 存在 需求 说 明 仓库 中 。FitNesse 的 wiki 系统 
或 者 Cucumber 功 能 文件 的 目录 结构 就 是 这 样 的 例子 。 

2.8.5 可 执行 的 需求 说 明 

当 开发 人 员 开 始 实现 需求 说 明 所 描述 的 功能 时 ， 基 于 需求 说 明 的 
测试 开始 时 会 失败 ， 因 为 测试 还 没有 自动 化 ， 功 能 也 还 没有 实现 。 

开发 人 员 会 实现 相关 功能 并 把 它 与 自动 化 框架 关联 在 一 起 。 他 们 
使 用 自动 化 框架 从 需求 说 明 中 获得 输入 并 验证 预期 的 输出 ， 而 不 需要 
实际 修改 需求 说 明文 档 。 第 9 章 中 的 概念 和 实践 将 帮助 我 们 有 效 地 自动 
化 需求 说 明 。 当 验证 实现 自动 化 以 后 ， 需 求 说 明 就 变 成 可 执行 的 了 。 

2.8.6 活 文 档 

所 有 已 实现 功能 的 需求 说 明 需 要 频繁 地 进行 验证 ， 一 般 通过 自动 
化 构建 过 程 来 实现 。 这 样 可 以 确保 需求 说 明 保持 更 新 ， 同 时 有 助 于 吉 
免 功 能 退化 的 问题 。 团 队 使 用 第 10 章 中 的 实践 可 以 使 频繁 验证 顺利 进 
行 。 

当 实现 了 整个 用 户 故事 的 时 候 ， 需 要 有 人 去 做 首次 验证 以 确保 其 
已 经 完成 ， 然 后 重组 需求 说 明确 保 它 和 已 实现 功能 的 需求 说 明 是 一 致 
的 。 他 们 将 采用 第 11 章 的 实践 ， 从 需求 说 明 逐 步 演化 出 文档 系统 。 举 
例 来 说 ， 他 们 可 能 将 免费 送 货 的 需求 说 明 移 到 送 货 相关 的 功能 体系 
中 ， 也 可 能 将 它们 和 其 他 因素 促 发 的 免费 送 货 实例 合并 在 一 起 。 为 了 


更 容易 地 访问 文档 ， 他 们 可 能 会 在 免费 送 货 的 需求 说 明和 其 他 送 货 类 
型 的 需求 说 明之 间 建 立 和 链接。 

然后 这 个 循环 再 次 开始 。 一 旦 我 们 需要 再 次 回顾 免费 送 货 的 规则 
一 一 比如 ， 在 做 高 级 奖励 计划 ， 或 是 扩展 功能 把 审 书 籍 的 订单 和 其 他 
货物 订单 分 离开 的 时 候 一 一 我 们 就 可 以 使 用 活 文档 来 理解 现 有 的 功能 
并 注 明 需要 修改 的 地 方 。 我 们 可 以 使 用 已 有 的 实例 来 协作 制定 需求 说 
明 ， 同 时 举例 说 明 会 更 加 有 效 。 然 后 我 们 会 举 出 另 一 组 关键 实例 ， 进 
一 步 帝 进 免费 壕 货 的 需求 说 明 ， 这 部 分 最 终 会 和 需求 说 明 的 其 他 部 分 
合并 到 一 起 。 这 个 循环 会 不 断 重 复 。 

现在 我 已 经 对 关键 流程 模式 做 了 一 个 简要 的 说 明 ， 大 家 可 以 通过 
第 3 章 对 活 文 档 有 一 个 更 深入 的 了 解 。 在 第 4 章 里 ， 我 会 介绍 如 何 开始 
采用 实例 化 需求 说 明 ， 这 伴随 着 实现 个 人 流程 模式 的 思想 ， 将 会 在 第 
二 部 分 进行 介绍 。 


2.9 铭记 


实例 化 需求 说 明 的 主要 过 程 模式 是 从 目标 中 获取 范围 、 协 作 制 定 
需求 说 明 、 举 例 说 明 、 提 炼 需求 说 明 、 自 动 化 验证 时 不 修改 需求 说 
明 、 频 繁 验证 以 及 演进 出 活 文 档 系 统 。 

对 于 实例 化 需求 说 明 而 言 ， 功 能 需求 、 需 求 说 明和 验收 测试 都 是 
一 回 事 。 

其 结果 是 一 个 活 文档 系统 ， 它 解释 系统 可 以 做 什么 ， 并 且 与 编程 
语言 代码 一 样 确切 和 可 靠 ， 但 更 容易 理解 。 

不 同 背 景 的 团队 使 用 不 同 的 实践 来 实施 过 程 模式 。 


第 3 章 活 文档 


目前 ， 我 们 一 般 认 为 实例 化 需求 说 明 的 过 程 和 工件 有 两 种 流行 的 
模型 : 以 验收 测试 为 中 心 的 模型 和 以 系统 行为 规范 为 主导 的 模型 。 


以 验收 测试 为 中 心 的 模型 (通常 称 为 验收 测试 驱动 开发 ，ATDD 
或 者 A-TDD) 侧重 于 自动 化 测试 ， 并 把 它 作 为 实例 化 需求 说 明 过 程 的 
一 部 分 。 这 个 模型 的 主要 优点 是 开发 目标 更 加 明确 ， 并 且 可 以 防止 功 
能 退化 。 

以 系统 行为 规范 为 主导 的 模型 (通常 称 为 行为 驱动 开发 或 者 
BDD) 侧重 于 制定 系统 行为 的 场景 。 它 的 主要 工作 是 通过 协作 和 需求 
澄清 ， 在 项 目 干系 人 和 交付 团队 之 间 建 立 起 共识 。 该 模型 认为 ， 通 过 
自动 化 测试 预防 功能 退化 也 很 重要 。 

我 认为 这 两 个 模型 不 存在 哪个 更 优 的 问题 ， 不 同 的 模型 有 不 同 的 
用 途 。 首 次 采用 实例 化 需求 说 明 时 ， 如 果 一 个 团队 有 很 多 功能 上 的 质 
量 问题 ， 那 么 以 验收 测试 为 中 心 的 模型 更 加 有 用 。 当 一 切 运行 顺畅 的 
时 候 ， 对 于 说 明 软 件 交 付 的 中 短期 活动 ， 以 系统 行为 规范 为 中 心 的 模 
型 会 比较 有 用 。 

在 这 两 个 模型 中 ， 通 过 自动 化 测试 预防 功能 退化 是 实例 化 需求 说 
明 的 主要 好 处 ， 而 且 这 种 好 处 具有 长 期 性 。 尽 管 回 归 测 试 的 确 很 重 
要 ， 但 我 并 不 认为 这 种 长 期 好 处 是 它 产生 的 。 首 先 ， 实 例 化 需求 说 明 
并 不 是 唯一 可 以 防止 功能 退化 的 方法 。 例 如 ，uSwitch 的 团队 在 首次 实 
现 了 相关 功能 后 ， 蔡 用 了 许多 测试 〈 详 见 第 12 章 ) ， 但 他 们 仍然 保持 
着 很 高 的 质量 。 其 次 ，Capers Jones 在 Estimating Software Costs 一 书 中 
指出 ， 通 过 回归 测试 移 除 缺 陷 的 平均 效率 仅 有 23% 。 这 无 法 证 明成 
功 的 团队 在 实现 实例 化 需求 说 明 上 作出 长 期 投资 是 正确 的 。 


注释 : (参见 Estimating Software Costs:Bringing Realism to 
Estimating 一 书 (McGraw-Hill，2007 年 ) 第 509 页 。 中 文 版 名 为 《软件 项 
目 估 计 》， 由 电子 工业 出 版 社 于 2008 年 出 版 。 同 时 请 参考 


http://gojko.net/2011/03/03/simulating-your-way-out-of-regressiontestingo 


在 为 编写 本 书 做 调研 时 ， 我 曾 有 笠 采 访 了 一 些 使 用 实例 化 需求 说 
明达 5 年 甚至 更 久 的 团队 。 他 们 的 经 验 ， 尤 其 是 最 近 几 年 的 经 验 ， 帮 助 
了 我 从 另 一 个 不 同 的 视角 一 一 以 文档 为 中 心 去 看 待 事情 。 很 多 我 采访 


的 团队 意识 到 ， 将 实例 化 需求 说 明 的 工件 作为 长 期 的 文档 是 很 有 价值 
的 。 大 部 分 团队 曾 尝 试 各 种 方法 来 定义 需求 说 明和 测试 ， 在 历经 数 年 
之 后 才 发 现 这 一 点 。 作 为 本 书 的 作者 ， 我 的 一 个 主要 目标 就 是 要 展现 
实例 化 需求 说 明 最 好 的 工件 一 一 活 文档 。 这 将 有 助 于 读者 从 容 迅速 地 
实现 一 个 活 文档 系统 ， 而 无 需 耗费 几 年 的 时 间 反 复试 验 。 

在 本 章 中 ， 我 会 介绍 文档 模型 及 其 好 处 。 这 个 模型 关注 业务 流程 
的 文档 ， 确 保 对 业务 流程 长 期 有 效 的 维护 和 支持 。 该 模型 对 确保 实例 
化 需求 说 明 发 挥 长 期 作用 特别 有 用 ， 它 还 可 以 防止 许多 常见 的 测试 维 
护 实现 问题 (本 章 稍 后 会 有 更 多 介绍 ) o 


3.1 2 


我 遇 到 过 太 多 次 这 样 的 情况 了 ， 别 人 塞 给 了 我 一 本 天 于 系统 的 厚 
厚 的 书 ， 同 时 告诫 我 那 本 书 “ 并 不 完全 正确 "。 宛 长 的 纸 质 文档 就 像 廉 
价 的 葡萄 酒 一 样 会 很 快 过 期 ， 如 果 你 在 创建 一 年 后 再 去 使 用 它 ， 会 很 
头痛 的 。 反 过 来 ， 维 护 一 个 没有 任何 文档 的 系统 同样 令 人 头疼 。 

我 们 要 了 人 解 一 个 系统 是 做 什么 的 ， 这 样 才 能 对 建议 的 变更 所 带 来 
的 影响 做 出 分 析 、 提 供 支 持 并 排除 故障 。 通 常 ， 找 出 系统 在 做 什么 的 
唯一 途径 是 浏览 程序 的 源 代码 ， 并 反 向 推导 出 系统 的 业务 功能 。 
Christian Hassa 是 TechTalk 公 司 心 的 合伙 人 ， 当 我 为 了 编写 这 本 书 采 访 
他 的 时 候 ， 他 把 从 代码 中 挖掘 系统 功能 的 过 程 叫做 “系统 考古 学 ”。 他 
解释 了 大 部 分 读者 都 非常 熟悉 的 一 种 情况 : 


注释 : (DTechTalk 公 司 开 发 了 .NET 里 的 BDD 工 具 SpecFlow。 
译 者 注 


“我 们 有 一 个 项 目 需要 蔡 换 一 个 和 遗留 系统 。 没 有 人 知道 某 个 计算 结 
果 或 报表 是 如 何 产生 的 。 用 户 只 是 一 味 地 使 用 计算 结果 并 盲目 地 信任 
老 的 系统 。 从 旧 的 应 用 程序 反 向 推导 出 需求 真 令 人 恐怖 啊 ， 当 然 了 ， 
结果 发 现 老 系统 的 某 些 逻 辑 是 错误 的 。>” 


即便 那些 没 文档 的 代码 是 正确 的 ， 对 于 商业 用 户 、 测 试 人 员 、 支 
持 工 程 师 来 说 ， 反 向 工程 是 一 件 几乎 无 法 完成 的 任务 。 在 大 部 分 项 目 
中 ， 甚 至 一 般 的 开发 人 员 也 做 不 到 。 显 然 ， 反 向 工程 的 做 法 是 行 不 通 
的 ， 我 们 需要 更 好 的 办 法 。 

良好 的 文档 不 仅仅 对 软件 开发 非常 有 用 。 许 多 公司 都 因为 对 他 们 
自己 的 业务 流程 拥有 良好 的 文档 而 受益 顾 多 ， 尤 其 是 当 越 来 越 多 的 业 
务 用 上 技术 时 。 同 其 他 类 型 的 系统 文档 一 样 ， 业 务 流 程 的 文档 很 难 编 
写 ， 而 且 维 护 成 本 也 很 高 。 

理想 的 解决 方案 是 一 种 易于 维护 并 且 维 护 成 本 较 低 的 文档 系统 ， 
这 样 即便 频繁 改动 底层 的 编程 语言 代码 ， 它 也 还 能 与 系统 功能 保持 一 
致 。 事 实 上 ， 任 何 一 种 全 面 的 文档 都 面临 着 维护 成 本 高 昂 的 问题 。 以 
我 的 经 验 来 看 ， 改 动 过 时 的 内 容 不 是 主要 的 成 本 所 在 ， 伦 时 间 去 找 出 
需要 改动 的 地 方 通 单 才 是 成 本 较 高 的 地 方 。 


自动 化 测试 的 问题 则 相反 。 找 出 所 有 需要 更 新 的 地 方 很 容易 ， 可 
以 频繁 地 执行 自动 化 测试 ， 任 何 失败 的 测试 显然 不 再 与 底层 代码 同 
步 。 但 是 ， 除 非 测 试 设计 得 易于 修改 ， 否 则 在 系统 更 改 后 去 更 新 这 些 
测试 可 能 会 耗费 很 多 时 间 。 以 验收 测试 为 中 心 的 方法 ， 其 缺陷 之 一 就 
是 会 忽略 这 种 影响 。 

注重 编写 测试 和 执行 测试 的 团队 往往 会 编写 出 不 易 维护 的 测试 。 
随 着 时 间 的 推移 ， 很 多 问题 会 迫使 这 些 团 队 去 寻求 制定 测试 并 将 测试 
自动 化 的 方法 ， 以 便 让 测试 更 容易 更 新 。 一 旦 测试 变 得 易于 维护 ， 团 
队 就 会 看 到 实例 化 需求 说 明 带 来 的 其 他 长 期 收益 。Adam Knight 的 团队 
效力 于 RainStor 公 司 一 一 一 家 位 于 英国 的 在 线 数据 存储 方案 供应 商 ， 
他 们 意识 到 ， 如 果 测 试 能 展现 出 背后 的 根本 目的 ， 那 么 它们 就 是 易于 
维护 的 。 他 说 : 

“在 开发 一 套 自 动 化 测试 时 ， 如 果 你 能 正确 地 将 它们 建立 起 来 ， 用 
它们 展现 背后 的 根本 目的 ， 那 么 你 就 可 以 将 它们 作为 文档 了 。 我 们 制 


作出 HTML 报 表 ， 列 出 运行 过 的 测试 及 其 目的 。 调 查 任 何 的 回归 失 履 
都 变 得 容易 多 了 。 你 可 以 更 容易 地 解决 冲突 ， 因 为 不 用 回头 去 查看 其 
他 文档 就 能 了 解 其 背后 的 目的 。” 

我 觉得 最 后 一 句 是 最 重要 的 : 如 果 测 试 很 清晰 ， 他 们 就 不 必 使 用 
任何 其 他 类 型 的 文档 了 。ePlan Services 的 Lisa Crispin 说 ， 对 她 而 言 ， 
最 郁 然 开朗 的 时 刻 之 一 ， 就 是 当 她 理解 了 把 测试 作为 文档 是 多 么 有 价 
值 的 时 候 : 

“我 们 获得 了 贷款 的 还 款 ， 但 系统 收取 的 利息 金额 不 正确 。 我 们 认 
为 系统 有 缺陷 。 我 可 以 查看 FitNesse 测 试 并 输入 数值 。 也 许 是 需求 错 
了 ,但 目前 的 代码 就 是 这 么 计算 的 。 这 节约 了 很 多 时 间 。>” 

Andrew Jackman 说 Sierra 团 队 把 测试 结果 作为 技术 支持 的 知识 库 : 

“业务 分 析 师 总 是 可 以 看 到 这 种 好 处 。 当 有 人 询问 Sierra 中 的 某 些 
数据 是 怎么 来 的 ， 他 们 常常 只 把 测试 结果 的 链接 发 过 去 即 可 一 一 那 是 
合理 的 文档 。 我 们 的 需求 说 明 都 不 放 在 Word 文 档 中 。>” 

前 文 我 提 到 过 爱人 入 华 州 助 学 贷 款 公 司 的 团队 ， 他 们 使 用 测试 估算 
业务 模型 变更 的 影响 ， 并 指导 其 实现 。SongKick 公 司 的 团队 使 用 他 们 
的 测试 来 指导 系统 变更 的 实现 ， 并 节省 了 大 约 50% 的 时 间 。 我 还 从 其 
他 许多 团队 听 到 过 类 似 的 故事 。 

当 团 队 使 用 某 种 信息 去 指导 开发 工作 ， 实 施 系统 支持 ， 或 者 估算 
业务 变更 的 影响 时 ， 将 这 种 信息 称 为 “测试 "会 让 人 产生 误解 。 支 持 并 
演 进 我 们 系统 的 并 不 是 测试 ， 而 是 文档 。 


当 一 个 软件 系统 持续 地 受到 一 系列 可 执行 需求 说 明 的 验证 时 ， 
队 可 以 确信 系统 会 按照 需求 说 明 所 述 的 情形 工作 或 者 ， 换 言 之 ， 
需求 说 明 会 持续 描述 系统 的 行为 。 那 些 需求 说 明 与 系统 同 存 ， 而 且 它 
们 始终 保持 一 致 。 由 于 我 们 能 立刻 发 现 需求 说 明 与 系统 功能 之 间 的 差 
异 ， 就 可 以 以 较 低 的 成 本 让 它们 保持 一 致 。 爱 荷 华 州 助 学 贷 款 公司 的 
Tim Andersen 曾 经 说 过 ， 他 只 相信 这 种 文档 : 


“如 果 我 拥有 的 文档 不 是 自动 化 的 ， 我 就 不 会 信任 它 。 那 种 文档 是 
未 经 实践 检验 的 。” 

可 执行 的 需求 说 明 创 建 出 文档 的 主体 ， 一 个 关于 系统 功能 的 权威 
信息 来 源 不 会 遭遇 “不 完全 正确 ”的 问题 ， 而 且 维 护 成 本 相对 较 低 。 如 
果实 例 化 需求 说 明 是 书 中 的 一 些 页 面 ， 那 么 活 文 档 系 统 就 是 一 本 书 。 

团队 交付 正确 产品 所 需 的 所 有 工件 都 可 以 用 活 文档 代替 ， 它 甚至 
有 助 于 外 部 用 户 手 册 的 编写 〈 尽 管 不 太 可 能 代替 它们 ) o CREA 
周期 迭代 或 者 流程 化 的 过 程 。 由 于 我 们 可 以 在 构建 软件 系统 的 过 程 中 
逐步 地 制定 出 需求 说 明 ， 因 此 最 终 产生 的 文档 是 增 量 式 的 ， 而 且 编写 
人 
该 文档 来 演进 软件 并 帮助 我 们 经 营业 务 。 当 有 人 在 编制 500 页 的 材料 
时 ， 没 有 必要 让 世界 停止 6 个 月 。 eee 
敏捷 开发 最 基本 的 认识 之 一 : 

“敏捷 初学 者 会 认为 敏捷 是 没有 文档 的 ， 这 不 是 事实 。 敏 捷 建 议 我 
们 要 选择 那些 有 用 的 文档 。 对 那些 害怕 没有 文档 的 人 而 言 ， 这 样 的 测 
试 是 一 个 保护 他 们 自己 的 绝 佳 机 会 ， 同 时 可 以 让 他 们 看 到 在 敏捷 过 程 
中 仍然 是 有 文档 的 ， 而 且 那 并 不 是 两 英尺 高 的 一 大 堆 纸 ， 而 是 一 种 更 
轻 量 级 但 紧密 绑 定 在 实际 代码 上 的 文档 。 当 你 询问 “你 们 的 系统 是 否 有 
这 种 功能 的 时 候 ， 你 没有 一 份 用 来 记录 系统 功能 的 word 文 档 ， 相 反 
你 有 一 种 可 以 执 生 TE R EA RAs 
那 才 是 真正 的 文档 。 

大 部 分 实例 化 需求 说 明 使 用 的 自动 化 工具 已 经 支持 通过 网 站 来 管 
理 需求 说 明 ， 或 者 把 测试 结果 导出 为 HTML 或 PDF 的 形式 ， 这 是 构建 
起 一 个 文档 系统 的 恨 好 起 点 。 我 期 望 未 来 几 年 内 会 出 现 很 多 创造 性 的 
工具 ， 帮 助 我 们 根据 实例 化 需求 说 明 建 立 起 文档 。 有 一 个 有 趣 的 项 目 
Relish ， 它 可 以 从 一 些 自动 化 工具 中 导入 实例 化 的 需求 说 明 ， 通 
过 格式 化 可 以 创建 出 一 个 文档 系统 ， 用 起 来 很 方便 。 请 看 图 3-1。 


注释 : 〈D 请 参考 www.relishapp.como 


图 3-1 Relish 根 据 可 执行 的 需求 说 明 建立 起 来 的 文档 站 点 


3.4b vy y 


实例 化 需求 说 明 以 文档 为 中 心 的 模型 可 以 帮助 团队 避免 长 期 维护 
可 执行 需求 说 明 时 最 常见 的 问题 ， 同 时 它 也 可 以 帮助 团队 建立 起 有 用 
的 文档 ， 随 着 时 间 的 推移 这 种 文档 可 以 促进 软件 的 革新 ， 并 避免 由 于 
缺乏 共享 知识 而 造成 的 维护 问题 。 

很 多 我 采访 过 的 团队 ， 在 持续 使 用 实例 化 需求 说 明 并 用 它 指导 所 
有 工作 时 ， 替 换 掉 了 他 们 的 系统 核心 ， 或 者 重 写 了 系统 的 大 部 分 地 
方 。 这 就 是 活 文档 真实 的 投资 回报 。 无 需 在 系统 考古 和 验证 上 花费 数 
月 的 时 间 ， 活 文档 系统 已 经 可 以 为 技术 更 新 或 变更 提供 需求 了 。 

我 认为 团队 应 该 把 活 文档 看 作 是 单独 的 工件 ， 与 他 们 交付 的 系统 
同等 重要 。 将 文档 当成 关键 性 交付 物 是 以 文档 为 中 心 的 模型 最 核心 的 


部 分 。 我 觉得 这 个 模型 可 以 解决 大 部 分 导致 团队 使 用 实例 化 需求 说 明 
失败 的 常见 问题 。 虽 然 本 书 中 还 没有 任何 案例 可 以 证 明 这 一 点 ， 但 我 
认为 这 是 未 来 的 重要 前 提 。 我 希望 本 书 的 读者 以 这 个 不 同 的 视角 去 看 
待 他 们 的 过 程 时 ， 可 以 更 容易 、 更 快速 地 取得 卓越 的 成 果 。 

比如 ， 明 白 活 文档 是 一 个 重要 工件 后 ， 你 立马 可 以 决定 是 否 将 验 
收 测 试 放 到 版 本 控制 系统 里 。 侧 重 于 业务 流程 文档 可 以 避免 过 度 关 心 
技术 需求 说 明 ， 还 可 以 保持 需求 说 明 从 业务 的 角度 去 关注 系统 应 该 做 
的 事情 ， 而 不 是 去 关注 测试 脚本 。 清 理 测 试 代码 不 再 需要 单独 的 说 
明 。 增 强 测试 的 结构 或 者 澄清 测试 意图 不 再 会 成 为 技术 负债 : 它们 是 
标准 交付 任务 的 一 部 分 。 把 验收 测试 的 工作 委托 给 初级 开发 人 员 和 测 
试 人 员 是 有 问题 的 ， 这 一 点 突然 变 得 非常 明显 。 有 用 的 文档 必定 是 组 
织 良好 的 ， 这 会 防止 团队 把 成 千 上 万 难以 理解 的 测试 放 在 同一 目录 
中 。 
把 活 文档 看 成 交付 过 程 的 单独 工件 ， 团 队 还 可 以 避免 对 它 投 资 过 
度 。 他 们 可 以 事先 讨论 准备 从 多 少时 间 去 构建 活 文档 系统 ， 以 免 挥 入 
这 样 一 个 陷阱 : 对 测试 进行 镀金 ， 却 牺牲 了 主要 的 产品 。 

我 认为 需求 说 明 过 于 抽象 可 能 是 文档 模型 的 一 个 潜在 陷阱 。 我 期 
望 这 个 模型 在 将 复杂 业务 流程 进行 目 动 化 的 软件 系统 中 能 发 挥 更 大 的 
作用 。 以 用 户 界 面 为 中 心 的 项 目 可 能 束 不 会 从 中 受益 那么 多 ， 因 为 这 
种 项 目的 复杂 度 不 在 其 底层 的 业务 流程 中 。 


3.5 铭记 


实例 化 需求 说 明 有 几 种 模型 ， 不 同 的 模型 有 不 同 的 用 途 。 

实例 化 需求 说 明 允 许 你 渐进 性 地 建立 起 一 个 良好 的 文档 系统 。 

活 文档 是 交付 过 程 的 重要 工件 ， 与 代码 一 样 重要 。 

侧重 于 建立 业务 流程 文档 系统 可 以 帮助 你 避免 长 期 维护 需求 说 明 
和 测试 造成 的 大 部 分 党 见 问题 。 


第 4 章 开始 改变 


实例 化 需求 说 明 的 很 多 中 心思 想 已 经 存在 几 十 年 了 。20 世 纪 80 年 
代 晚 期 ，Gerald Weinberg 和 Donald Gause 在 《探索 需求 》 一 书 中 谈 
到 了 软件 需求 的 沟通 问题 。 这 两 位 作者 认为 ， 检 查 需 求 的 完整 性 和 一 
致 性 的 最 好 方式 ， 就 是 针对 它们 设计 黑 盒 测试 一 一 实际 上 这 就 表明 了 
实例 化 需求 说 明 既 是 需求 说 明 又 是 测试 的 两 重 性 。1986 年 ， 德 国 军 方 
使 用 了 一 种 手法 ， 用 来 描述 那些 为 了 进行 验证 ， 在 实施 之 前 就 建立 验 
收 测 试 的 方法 ， 这 种 手法 后 来 演变 成 了 V 模 型 。 今 天 ， 我 们 使 用 的 是 
同样 的 方法 ， 但 是 把 验收 测试 当 作 带 实例 的 需求 。1989 年 ，Ward 
Cunningham 在 WyCASH+ 项 目 中 应 用 了 举例 说 明和 不 修改 需求 说 明 进 
行 自动 化 验证 的 一 些 实践 。 包 


注释 : (DGerald M.Weinberg 和 Donald C.Gause 合 著 的 Exploring 
Reguirements: Quality Before Design(Dorset House Publishing 


Company，1989 年 出 版 ) 
注释 : @http://fit.c2.com/wiki.cgi? FrameworkHistory 


不 笠 的 是 ， 这 些 思想 当时 没 流行 开 来 。 漫 长 的 开发 阶段 使 得 它们 
难以 实行 。 人 们 得 花 上 几 个 月 的 时 间 ， 为 那些 持续 数 年 的 项 目 编写 抽 
象 的 需求 。 事 先 以 实例 详细 说 明 一 切 ， 会 使 项 目 延 误 得 更 久 。 

敏捷 开发 改变 了 业界 对 软件 交付 阶段 的 看 法 ， 并 显著 地 缩短 了 这 
些 阶 段 。 这 让 实例 化 需求 说 明 变 得 切实 可 行 。 迭 代 和 基于 流程 的 项 目 
可 以 极 大 地 受益 于 实例 化 需求 说 明 。 以 如 此 短 的 时 间 完 成 一 个 交付 阶 
段 ， 我 们 需要 尽量 消除 不 必要 的 工作 。 需 要 解决 的 常见 问题 是 返工 、 
沟通 不 畅 导 致 的 重复 工作 、 为 了 理解 系统 而 回头 阅读 代码 所 浪费 的 时 
间 ， 以 及 手工 重复 执行 相同 测试 所 消耗 的 时 间 。 使 用 短 迭 代 或 恒定 速 
率 的 流程 进行 有 效 的 交付 时 ， 需 要 尽 可 能 多 地 排除 可 以 预期 的 障碍 ， 
这 样 ， 意 外 的 问题 才能 得 以 解决 。Adam Geras 意 味 深长 地 说 : “高 标准 
就 是 要 为 应 对 寻常 问题 做 好 准备 ， 这 样 你 才 有 了 时间 去 处 理 不 寻常 的 问 
题 。” 活 文档 可 以 轻易 地 消除 常见 问题 。 


实例 化 需求 说 明 是 解决 方案 : 一 种 处 理 寻常 问题 的 手段 ， 这 样 在 
几 天 或 几 周 的 软件 交付 周期 内 ， 我 们 才 有 更 多 的 时 间 去 处 理 不 寻常 的 
问题 。 如 今 ， 活 文档 是 取得 成 功 的 一 个 必要 条 件 。 

本 章 中 ， 我 们 将 探讨 如 何 着 手 改变 过 程 和 团队 文化 ， 以 便 你 去 实 
施 实例 化 需求 说 明 。 我 们 将 回顾 三 个 团队 的 案例 研究 ， 它 们 使 用 了 不 
同 的 方法 ， 将 协作 制定 需求 说 明 集 成 到 了 过 代 和 流程 式 的 开发 中 。 最 
后 ， 我 会 提出 一 些 有 用 的 想法 ， 让 这 个 过 程 运用 于 那些 对 需求 有 签收 
要 求 和 可 追溯 性 要 求 的 开发 环境 。 


开始 改变 一 个 过 程 从 来 都 不 容易 ， 特 别 是 想 从 根本 上 改变 团队 成 
员 之 间 的 合作 方式 。 为 了 挺 过 初期 的 抵制 ， 为 将 来 的 变革 建立 一 个 成 
功 的 范例 ， 大 多 数 团队 一 开始 都 会 实施 一 个 短期 内 能 改善 产品 质量 或 
者 节省 时 间 的 实践 。 最 常见 的 出 发 点 有 以 下 这 些 。 

如 果 已 经 在 进行 一 个 过 程 变更 ， 那 么 就 通过 它 实 现实 例 化 需求 说 
明 的 主要 思想 。 

将 实例 化 需求 说 明 的 思想 当 作 改善 产品 质量 的 灵感 。 

为 那些 没有 自动 化 功能 测试 的 团队 ， 实 施 功能 测试 的 自动 化 。 

为 那些 自动 化 测试 与 开发 环节 相 脱 离 的 团队 ， 引 入 自动 化 的 可 执 
行 需求 说 明 。 

对 那些 实践 测试 驱动 开发 (TDD) 的 团队 ， 使 用 TDD 作 为 下 一 步 的 
踏 脚 石 。 

所 有 这 些 出 发 点 都 会 在 短期 内 产生 效益 ， 并 能 够 带 来 进一步 的 改 


在 我 采访 的 团队 中 ， 有 4 个 团队 在 转向 敏捷 软件 开发 的 过 程 中 ， 实 
施 了 实例 化 需求 说 明 的 核心 思想 。 不 用 面临 别人 对 于 过 程 变更 的 抵 


触 ， 也 不 用 获得 管理 层 的 支持 。 
= 实施 Scrum、XP 或 任何 其 他 敏捷 过 程 终 归 是 一 种 休克 疗法 ， 因 
此 如 果 有 可 能 的 话 ， 可 以 把 实施 实例 化 需求 说 明 也 纳入 其 中 。 


敏捷 


能 够 做 到 这 一 点 的 团队 出 现 的 问题 比较 少 ， 并 且 相 比 那 些 从 功能 
不 健全 的 Scrum 环 境 开始 变更 的 团队 ， 其 过 程 的 实施 会 更 加 迅速 。 主 
要 原因 是 在 敏捷 转型 过 程 中 ， 这 4 个 团队 都 得 到 了 重大 的 支援 (其 中 3 
个 团队 有 咨询 师 在 现场 ， 另 一 个 团队 的 一 位 成 员 曾 经 参与 过 实例 化 需 
求 说 明 的 实践 ) 。 

4.1.2 专注 于 提高 


uSwitch ( 详 见 第 12 章 ) 的 团队 决定 专注 于 提高 产品 质量 ， 而 不 是 
专注 于 某 个 特定 过 程 。 他 们 要 求 所 有 队员 提出 改进 建议 ， 并 从 中 找到 
灵感 。 最 终 他 们 实施 了 实例 化 需求 说 明 的 大 多 数 过 程 模式 ， 中 间 只 
到 微小 的 阻力 。 

从 管理 角度 来 看 ， 如 果 团队 中 有 很 多 人 可 能 会 去 抵制 某 个 过 程 变 
更 ， 那 么 专注 于 提高 质量 就 是 一 个 特别 好 的 方法 。 人 们 可 能 会 对 
Scrum、 敏 捷 、 实 例 化 需求 说 明 、 看 板 或 其 他 流程 相关 的 事情 产生 抱 


怨 。 公 开 主 动 地 提高 质量 是 不 太 可 能 引起 抱怨 的 。David Andersonte 
倡 在 看 板 里 将 注重 质量 作为 获得 成 功 的 第 一 步 。 


注释 : 〇 请 参阅 David Anderson 的 Kanban: Successful Evolutionary 
Change for Your Technology Business 一 书 (Blue Hole Press，2010 年 出 
版 )。 


-> 先 找 出 提高 软件 质量 的 最 大 阻碍 ， 然 后 解决 这 个 问题 。 

如 果 开 发 人 员 和 测试 人 员 没有 一 起 紧密 合作 ， 并 且 对 是 否 接受 某 
件 东西 的 质量 拥有 不 同 的 看 法 ， 那 么 把 有 关 产 品 发 布 的 一 些 行为 展示 
出 来 ， 可 能 会 很 有 用 。 在 提供 电子 金融 交易 服务 的 LMAX 公 司 ，Jodie 
Parker 创 建 了 一 个 发 布 候选 板 ， 上 面 显 示 了 3 个 团队 的 进度 概况 ， 这 样 
所 有 发 布 活动 都 变 得 可 视 了 。 它 的 作用 是 显示 所 有 计划 交付 项 的 状 
态 、 发 布 的 重点 、 发 布 前 必须 完成 的 一 系列 任务 ， 以 及 发 布 前 必须 解 
决 的 关键 问 题 。 所 有 团队 都 能 看 到 此 类 信息 ， 而 后 提出 改善 交付 流程 
的 建议 。 

4.1.3 MENEE 


适用 于 : 应 用 到 现 有 项 目 

我 采访 的 大 多 数 团队 都 是 从 功能 测试 自动 化 开始 采用 实例 化 需求 
说 明 的 ， 而 后 逐渐 从 先 开 发 后 测试 转 到 使 用 可 执行 的 需求 说 明 来 指导 
开发 。 对 那些 已 经 拥有 大 量 代 码 并 且 需 要 测试 人 员 手 动 执行 验证 的 项 
目 ， 这 种 方式 的 阻力 似乎 最 小 。 

有 几 个 团队 寻求 在 测试 阶段 解决 壮 颈 问题 ， 结 果 测 试 人 员 必 须 持 
续 地 追赶 开发 的 进度 。 在 短 交付 周期 ( 几 周 甚至 几 天 ) 里 ， 大 规模 手动 
测试 是 不 可 能 的 。 测 试 堆积 到 迭代 结束 的 时 候 ， 接 着 葛 延 到 下 一 轮 达 
代 ， 扰 乱 了 正常 的 开发 流 。 功 能 测试 自动 化 可 以 消除 这 种 瓶颈 ， 并 使 
得 开发 人 员 和 测试 人 员 共 同 参与 ， 激 励 他 们 参与 到 流程 变更 中 。 
Markus Gärtner : 


“对 一 个 遭受 测试 瓶颈 :之 苦 并 且 不 断 对 抗 开 发 变更 的 测试 人 员 来 
说 ， 通 过 自动 化 测试 来 提供 有 价值 的 反馈 (甚至 是 在 修复 缺陷 之 前 ) 
是 非常 、 非 常 、 非 常 具有 吸引 力 的 。 这 是 一 个 需要 努力 实现 的 激励 性 

景 。”> 

> 如 果 你 还 没有 实行 功能 测试 自动 化 ， 请 记 住 这 是 一 个 容易 实现 
的 目标 ， 一 个 开始 实施 实例 化 需求 说 明 的 简单 方式 。 

把 功能 测试 自动 化 作为 采用 实例 化 需求 说 明 的 第 一 阶段 是 很 有 效 
的 ， 原 因 如 下 。 

它 带 来 立竿见影 的 好 处 。 通 过 自动 化 的 测试 ， 测 试 阶段 的 时 间 显 
著 减 少 ， 遗 漏 到 生产 环境 的 问题 也 就 显著 减少 。 

有 效 的 测试 自动 化 需要 开发 人 员 和 测试 人 员 的 协作 ， 它 开始 打破 
这 两 个 群体 之 间 的 隔 头 。 

遗留 产品 很 少 有 支持 简便 测试 的 设计 。 从 功能 测试 自动 化 开始 ， 
可 以 迫使 团队 解决 这 个 问题 ， 让 架构 更 具 可 测 性 ， 同 时 可 以 解决 有 关 
测试 可 靠 性 和 测试 环境 的 问题 。 这 能 为 接 下 来 可 执行 需求 说 明 的 自动 
化 打 好 基础 。 

如 果 大 多 数 测试 都 是 手工 的 ， 并 且 团 队 以 短 周期 进行 工作 ， 那 么 
测试 人 员 往 往 就 是 过 程 中 的 瓶颈 。 这 使 得 他 们 几乎 不 可 能 从 事 任 何其 
他 事情 。 测 试 自动 化 让 他 们 有 时 间 去 参加 需求 说 明 工 作坊 ， 并 开始 尝 
试 其 他 活动 ， 例 如 探索 性 测试 。 

与 手动 测试 相 比 ， 测 试 自 动 化 可 以 让 团队 运行 更 多 的 测试 ， 而 且 
运行 得 更 加 频繁 。 这 往往 可 以 排除 缺陷 和 不 一 致 的 地 方 ， 同 时 透明 度 
的 突然 提升 有 助 于 商业 项 目 干 系 人 看 到 测试 自动 化 的 价值 。 

编写 以 及 开始 实施 功能 测试 自动 化 往往 需要 商业 用 户 的 参与 ， 他 
们 必须 判定 某 个 不 一 致 的 问题 是 缺陷 还 是 系统 本 身 的 运行 方式 。 这 会 
带 来 测试 人 员 、 开 发 人 员 和 商业 用 户 之 间 的 协作 。 同 时 ， 这 也 要 求 团 
队 自 己 找到 测试 自动 化 的 方法 ， 以 便 商 业 用 户 能 够 理解 ， 为 可 执行 的 
需求 说 明 准 备 好 适合 的 方法 。 

更 快速 的 反馈 有 助 于 开发 人 员 看 到 测试 自动 化 的 价值 。 


功能 测试 自动 化 有 助 于 团队 成 员 理解 可 执行 需求 说 明 自 动 化 所 需 
的 工具 。 
这 是 否 只 是 在 转移 工作 ? 

让 程序 员 协作 进行 测试 自动 化 可 以 解放 测试 人 员 ， 对 此 ， 一 个 党 
见 的 反对 意见 是 程序 员 因此 会 有 更 多 事情 要 做 ， 而 这 会 减 慢 功能 的 交 
付 。 事 实 上 ， 业 界 的 总 体 趋势 是 团队 的 程序 员 比 测试 人 员 多 ， 所 以 将 
工作 从 测试 人 员 转 移 到 开发 人 员 并 不 一 定 很 糟糕 “ 它 可 能 会 消除 过 
程 中 的 瓶颈 。 

实现 功能 测试 自动 化 将 使 团队 更 紧密 地 合作 ， 并 为 系统 以 后 使 用 
可 执行 的 需求 说 明 做 好 准备 。 为 了 使 这 种 方式 的 收益 最 大 化 ， 在 实现 
功能 测试 自动 化 的 时 候 ， 应 该 使 用 一 个 针对 可 执行 需求 说 明 而 设计 的 
工具 ， 并 使 用 第 9 章 和 第 11 章 的 思想 做 好 测试 的 设计 工作 。 使 用 传统 的 
“录制 播放 "测试 工具 不 会 带 来 你 所 需要 的 好 处 。 

从 系统 的 高 风险 部 分 开始 自动 化 

想 要 使 用 自动 化 测试 完全 覆盖 遗留 系统 是 徒劳 的 。 如 果 使 用 功能 
测试 自动 化 作为 实例 化 需求 说 明 的 一 个 步 又， 那么 你 应 该 编写 足够 多 
的 测试 来 展现 测试 自动 化 的 价值 ， 并 习惯 于 使 用 相关 的 工具 。 此 后 ， 
当 有 需求 变更 时 ， 就 可 以 开始 实现 可 执行 的 需求 说 明 ， 并 和 逐渐 增加 测 
RAN, 

为 了 从 最 早 实施 的 功能 测试 自动 化 中 获得 最 大 收益 ， 请 专注 于 将 
系统 中 存在 风险 的 那 部 分 先 自动 化 掉 ， 这 些 地 方 的 问题 会 花费 很 多 财 
力 。 防 止 那些 地 方 出 现 问题 可 以 立刻 体现 出 自动 化 的 价值 。 良 好 的 功 
能 测试 覆盖 率 将 使 团队 获得 更 多 的 信心 。 而 对 风险 较 小 的 部 分 进行 自 
动 化 所 带 来 的 好 处 可 能 不 值 一 担 。@ 


注释 : GD 详 见 http:Wgojko.neV2011/02/08/test-automation-strategy- 
for-legacy-systemSo 


4.1.4 一 个 可 执行 需求 i 下 


适用 于 : 测试 人 员 负 责 测试 自动 化 时 

在 那些 功能 测试 自动 化 完全 由 测试 人 员 负 责 的 项 目 中 ， 一 个 重大 
挑战 是 打破 测试 人 员 和 开发 人 员 之 间 的 无 形 隔 闵 。 在 这 种 情况 下 ,已 
经 不 需要 证 明 测 试 自动 化 的 价值 ， 也 不 需要 排除 测试 环境 的 问题 ， 但 
是 团队 必须 变 得 更 加 具有 协作 意识 。 

这 个 问题 更 多 是 文化 上 的 (之 后 会 详细 描述 ) ， 但 有 时 候 也 跟 财 
务 相 关 。 如 果 使 用 如 QTP 这 般 昂贵 的 测试 自动 化 框架 ， 按 人 数 购买 许 
可 ， 那 么 开发 人 员 和 业务 分 析 师 就 会 被 特意 隔离 ， 不 让 他 们 接触 测 
试 。 一 旦 团队 改变 态度 倾向 于 协作 ， 那 么 他 们 就 能 够 在 需求 说 明 上 进 
行 协 作 ， 进 行 验证 自动 化 时 也 不 用 去 修改 需求 说 明 。 

有 些 团 队 碰 到 某 个 问题 却 无 法 使 用 现 有 的 自动 化 工具 去 做 适当 的 
测试 ， 于 是 他 们 就 只 能 朝 可 执行 需求 说 明 的 方向 上 努力 了 。 正 是 这 种 
状况 让 他 们 获得 了 一 个 很 好 的 理由 来 开始 使 用 支持 可 执行 需求 说 明 的 
自动 化 工具 。( 详 见 附录 中 “工具 ”小 节 的 例子 ， 其 他 关于 工具 的 文章 请 
Whttp://specificationbyexample.com) 

- 这些 团 队 发 现 ， 使 用 支持 可 执行 需求 说 明 的 自动 化 工具 后 ， 开 
发 人 员 会 更 多 地 参与 到 测试 自动 化 中 ， 同 时 商业 用 户 也 能 够 对 测试 有 
更 深入 的 了 解 。 

如 此 一 来 ， 开 发 人 员 会 变 得 更 加 乐意 参与 到 测试 自动 化 中 ， 并 开 
始 在 自己 的 机 器 上 运行 这 些 测试 ， 因 为 他 们 看 到 了 从 功能 测试 上 获得 
快速 反馈 的 价值 。 商 业 用 户 也 能 理解 使 用 可 执行 需求 说 明 的 工具 进行 
自动 化 的 测试 ， 并 会 参与 制定 相关 的 验收 标准 。 在 这 之 后 ， 转 移 到 设 
计 可 执行 需求 说 明 并 事先 进行 测试 的 过 程 ， 就 相对 容易 了 。 

当 Rob Park 的 团队 与 一 家 大 型 保险 公司 合作 时 ， 系 统 需要 生成 
PDF 格式 的 保险 证 明 ， 他 们 以 此 为 由 ， 引 入 了 一 个 自动 化 可 执行 需求 
说 明 的 工具 ， 并 将 功能 测试 转移 到 了 开发 周期 的 早期 阶段 。Park 说 : 

“QTP 无 法 对 它 进行 测试 一 一 它 能 够 验证 弹出 窗口 没有 出 现 错误 
信息 ， 仅 此 而 已 。 我 想 要 的 是 能 够 让 开发 人 员 先 在 他 们 的 机 器 上 运行 
测试 ， 但 这 确实 是 QTP 的 限制 之 一 (由 于 需要 按 人 数 购买 许可 ) 。 后 


来 我 使 用 了 JBehave。 我 们 几乎 是 一 次 性 彻底 地 抛弃 了 QTP 的 一 切 ， 
实际 上 这 只 花 了 一 周 的 时 间 。 现 在 我 们 能 够 让 这 些 验收 测试 来 驱动 底 
层 控 制 器 的 设计 了 。” 

在 Weyerhaeuser 公 司 ，Pierre Veragen 和 团队 使 用 了 自 定义 的 测试 
自动 化 工具 ， 它 通过 录制 对 用 户 界面 的 操作 来 进行 测试 。 维 护 成 本 很 
高 。 有 一 次 ， 某 个 变更 导致 了 很 多 测试 出 错 ， 他 评估 后 发 现 ， 使 用 新 
的 工具 重 写 现 有 测试 比重 新 录制 出 错 的 测试 所 花 的 时 间 要 少 ， 于 是 他 
提出 采用 FitNesse。 采 用 FitNesse 使 得 团队 能 够 与 工程 师 一 起 更 紧密 地 
协作 ， 设 计 可 执行 的 需求 说 明 ， 也 坚定 了 他 们 采用 实例 化 需求 说 明 的 
决心 。 

4.1.5 EAMA Ska 7+ 22 TEAL Ee al 

适用 于 : 开发 人 员 对 TDD 有 较 深 认识 的 时 候 

-引入 实例 化 需求 说 明 的 另 一 个 常见 策略 ， 就 是 从 (单元 ) 测试 
驱动 开发 上 入 手 ， 特 别 是 在 开发 新 项 目的 时 候 。 

相对 于 实例 化 需求 说 明 ， 测 试 驱 动 开 发 的 实践 在 业界 更 具 知 名 度 
并 且 有 更 多 的 文档 。 如 果 一 个 团队 已 经 把 TDD 实 践 运用 得 很 好 ， 那 么 
很 可 能 不 需要 再 给 他 们 展示 目 动 化 测试 的 价值 了 ， 也 不 需要 为 了 让 软 
件 更 具 可 测 性 而 修改 设计 。 可 执行 的 需求 说 明 可 以 看 作 是 测试 驱动 开 
发 对 业务 规则 的 扩展 。 (验收 测试 驱动 开发 常常 是 实例 化 需求 说 明 的 
同义词 。) 

在 ePlan Services 公 司 ， 当 他 们 第 一 次 实施 实例 化 需求 说 明 时 ， 

Lisa Crispin 使 用 了 下 面 的 方法 : 

“一 开始 ， 我 无 法 让 人 们 对 验收 测试 感 兴趣 。 按 照 Mike Cohn 的 建 
议 ， 我 就 选 了 一 个 故事 ， 去 找 了 正 忙 于 此 故事 的 开发 人 员 并 问 他 : :我 
们 可 以 针对 这 个 故事 结对 编写 一 个 测试 吗 ? ;开发 人 员 将 会 看 到 这 是 件 
多 么 简单 的 事 。 在 下 一 轮 迭 代 里 ， 我 选择 了 不 同 的 故事 和 不 同 的 开发 
人 员 。 在 他 没有 真正 理解 需求 的 地 方 ， 我 们 很 快 就 发 现 了 一 个 缺陷 。 
这 样 开 发 人 员 立 刻 就 看 到 了 它 的 价值 。” 


当 团 队 对 TDD 有 较 深 的 认识 时 ， 很 容易 解释 可 执行 的 需求 说 明 : 
可 执行 的 需求 说 明 就 是 针对 业务 功能 的 测试 。 


从 很 大 程度 上 来 讲 ， 实 施 实例 化 需求 说 明 需 要 进行 文化 变革 一 一 
让 大 家 在 处 理 需求 时 进行 协作 ， 并 改变 业务 人 员 、 开 发 人 员 以 及 测试 
人 员 参 与 制定 需求 说 明 的 方式 。 下 面 是 一 些 有 用 的 想法 ， 有 助 于 改变 
团队 的 文化 。 


4.2.1 避免 使 用 “敏捷 ”术语 


MEE FA AN ASA MTNA. Scrum, WA, 
用 户 故 事 、 功 能 清单 (backlog)、 大 师 (master)、 结 对 编程 ， 以 及 其 他 一 
些 诸如 此 类 的 术语 ， 很 容易 让 人 产生 误解 并 导致 混乱 。 对 有 些 人 而 
言 ， 它 们 甚至 会 喧 宾 夺 主 ， 让 人 提心吊胆 。 术 语 造 成 的 焦虑 ， 是 导致 
大 家 回 退 到 从 前 并 抵制 任何 过 程 变 或 者 被 动 地 等 待 失败 到 来 的 
一 大 原因 。 以 我 的 经 历来 看 ， 许 多 业务 人 员 很 难 理解 开发 团队 使 用 的 
技术 术语 ， 因 而 很 难 理解 关于 过 程 改进 的 想法 ， 很 难 去 配合 团队 完成 
过 程 改 进 。 

-无 需 使 用 技术 术语 就 能 实施 实例 化 需求 说 明 ， 这 是 完全 可 能 
的 。 如 果 工 作 环境 抵制 变革 ， 那 么 开始 变革 时 就 一 定 要 避免 使 用 术 
To 

不 要 提 及 用 户 故事 、 验 收 测 试 或 可 执行 的 需求 说 明 一 一 实施 实例 
化 需求 说 明 的 时 候 不 要 提供 定义 。 这 样 反对 你 的 人 就 很 难 找到 什么 理 
由 来 反对 。 把 实例 化 需求 说 明 解 释 成 一 种 为 澄清 需求 而 搜集 实例 、 设 
计 测 试 ， 并 将 它们 自动 化 的 过 程 。 其 他 事情 就 让 大 家 自己 去 发 现 吧 。 

在 RainStor 公 司 ，Adam Knight 没 费 多 大 力气 就 实施 了 实例 化 需求 
说 明 的 大 部 分 关键 元 素 。 并 没有 什么 前 期 的 规划 ， 整 个 过 程 就 那样 慢 
慢 推进 着 ，Knight 说 公司 其 他 人 都 不 知道 什么 是 实例 化 需求 说 明 。 他 


说 :“ 实 际 上 大 家 并 没有 意识 到 有 什么 特殊 的 。” 对 他 的 团队 来 说 ， 那 
只 是 一 个 他 们 自己 建立 起 来 的 过 程 而 已 。 

Pierre Veragen 使 用 类 似 的 方法 帮助 Weyerhaeuser 的 一 个 团队 改进 
了 他 们 的 软件 过 程 。 那 个 团队 维护 着 一 个 遗留 系统 ， 有 上 百 万 行 代 
码 。 他 们 抵制 实施 任何 以 敏捷 为 名 的 东西 。Veragen 并 没有 说 什么 豪 言 
壮 语 ， 他 只 是 建议 在 用 户 界 面 之 下 进行 自动 化 测试 ， 以 便 让 测试 更 加 
高 效 。 当 大 家 接受 这 种 做 法 后 ， 他 接着 建议 开发 人 员 在 他 们 自己 的 机 
器 上 运行 测试 ， 以 便 获 得 更 快 的 反馈 ， 让 测试 和 开发 齐头并进 。 
Veragen 就 这 样 带 着 大 家 一 起 做 ， 并 密切 注视 着 团队 的 动向 ， 最 终 他 改 
变 了 团队 成 员 的 看 法 : 测试 并 不 是 开发 完成 后 才 做 的 事情 。 这 样 的 变 
化 花费 了 大 约 6 个 月 的 时 间 ， 主 要 是 因为 自动 化 测试 套件 必须 达到 一 定 
的 规模 后 ， 开 发 人 员 才 能 在 代码 中 引入 问题 后 看 到 有 测试 没有 通过 。 
Veragen 是 这 么 评论 的 : 

“工程 师 意识 到 ， 在 他 们 的 机 器 上 执行 失败 的 测试 实际 上 指出 了 代 
码 中 存在 的 问题 。 当 开发 人 员 碰 到 这 种 情况 时 ， 他 们 就 明白 了 ， 不 会 
再 询问 为 什么 他 们 必须 要 运行 那些 测试 。” 

实施 过 程 变 更 无 需 技术 术语 ， 只 需 使 问题 变 得 显而易见 ， 同 时 逐 
渐 把 大 家 推 向 解决 问题 的 正确 方向 上 就 可 以 了 。 当 团队 想 出 某 个 问题 
的 解决 方案 时 (即使 是 在 一 些 帮助 下 想 出 来 的 ) ， 他 们 会 产生 一 种 主 
人 丛 意 识 ， 也 会 更 自觉 地 去 遵循 过 程 变 更 。 


| 无 术语 区 | 


4.2.2 尔 得 到 管理 层 


实施 实例 化 需求 说 明 的 时 候 ， 大 部 分 团队 要 显著 地 改变 他 们 的 工 
作 方 式 。 对 很 多 团队 而 言 ， 这 意味 着 不 仅 要 改变 他 们 处 理 需求 说 明 、 
开发 以 及 测试 的 方式 ， 而 且 要 学 习 如 何 与 团队 内 部 以 及 外 部 的 项 目 干 
系 人 进行 更 好 的 协作 。 

很 多 人 会 对 角色 转变 感到 困惑 。 测 试 人 员 必 须 更 多 地 参与 分 析 ， 
开发 人 员 必 须 更 多 地 参与 测试 ， 分 析 师 必须 改变 他 们 搜集 和 沟通 需求 
的 方式 ， 业 务 人 员 则 必须 更 加 活跃 地 准备 需求 说 明 。 如 此 巨大 的 改变 
需要 得 到 管理 层 的 支持 ， 否 则 ， 它 们 注定 会 失败 。Clare McLennan 说 
道 : 

“项 目的 成 功 需要 得 到 管理 层 的 支持 ， 尤 其 是 当 已 经 有 一 个 系统 的 
时 候 ， 因 为 要 使 之 达到 运行 良好 、 稳 定 的 程度 ， 必 定 需要 花费 相当 多 
的 时 间 。 你 必须 参与 所 有 的 迭代 ， 查 看 哪里 尚未 稳定 、 哪 里 出 现 奇怪 
的 响应 ， 修 正 它 们 ， 并 不 断 重复 。 经 过 大 约 一 年 的 时 间 ， 你 才 会 得 到 
一 个 非常 宝贵 的 系统 。 反 之 ， 如 果 不 那么 做 ， 或 者 你 认为 手工 进行 用 


户 界面 测试 能 很 快 修正 缺陷 ， 那 么 你 最 终 得 到 的 系统 将 会 是 一 个 难以 
维护 并 且 价 值 不 大 的 东西 。” 

刚 开始 的 时 候 ， 目 动 化 可 执行 的 需求 说 明 对 许多 团队 来 说 都 具有 
挑战 性 ， 因 为 从 概念 上 来 说 ， 它 与 测试 人 员 和 开发 人 员 所 熟知 的 自动 
化 测试 是 不 同 的 〈 详 见 第 9 章 ) 。 团 队 必 须 学 习 如 何 使 用 新 的 工具 ， 找 
到 一 个 设计 可 执行 需求 说 明 的 好 万 法 ， 并 组 织 好 他 们 的 活 文档 。 在 起 
初 的 几 个 月 里 ， 开 发 团队 的 生产 率 在 升 高 以 前 ， 必 定 会 先 有 所 下 降 。 
这 也 需要 管理 层 的 理解 、 批 准 和 支持 。 

=> 没有 管理 层 的 认可 和 支持 ， 过 程 变更 成 功 的 几率 很 小 。 

如 果 管理 层 不 予 支持 ， 反 而 施加 压力 ， 那 么 大 家 就 会 退回 到 做 事 
的 老路 上 去 ， 并 开始 保护 他 们 自己 的 位 置 ， 而 不 是 进行 协作 。 与 管理 
层 分 享 第 1 章 列 出 的 成 功 故事 和 实例 化 需求 说 明 的 好 处 ， 应 该 有 助 于 获 
取 他 们 的 文 持 ， 但 如 果 失 败 了 ， 那 最 好 还 是 先 不 那么 雄心 过 劲 ， 而 以 
较 小 的 步骤 去 改进 过 程 。 


有 些 团队 ， 包 括 那些 在 严格 管理 的 环境 中 工作 的 团队 ， 认 为 把 用 
户 验收 测试 作为 软件 交付 中 的 一 个 阶段 是 没有 必要 的 。 (有 些 公司 把 
这 个 阶段 称 为 用 户 验 收 测试 或 业务 验收 测试 。) 虽然 这 并 不 代表 他 们 
不 为 用 户 验 收 做 测试 ， 但 制定 并 检查 验收 条 件 和 把 用 户 验 收 测试 作为 
软件 交付 的 一 个 阶段 是 不 同 的 。 用 户 验收 测试 是 非常 重要 的 ， 不 应 该 

到 最 后 才 去 做 。 可 执行 的 需求 说 明 以 及 频繁 的 验证 使 开发 团队 持续 
不 断 地 去 检查 用 户 的 验收 条 件 。 只 有 所 有 的 验收 测试 都 通过 ， 产 品 才 
会 交付 到 用 户 手 里 。 

如 果 可 执行 的 需求 说 明 足 够 广泛 ， 而 且 验 证 足够 频繁 ， 那 么 开发 
团队 与 客户 之 间 的 信任 会 增强 到 这 样 的 程度 : 在 软件 交付 后 ， 手 工 验 
证 软件 的 功能 变 得 不 再 必要 。 (当然 ， 这 并 不 代表 测试 人 员 可 以 在 交 
付 前 不 进行 探索 性 测试 。) 


-我 认为 ， 大 部 分 团队 是 能 够 以 避免 把 验收 测试 拖 到 最 后 为 理由 
证 明 实施 实例 化 需求 说 明 的 花费 是 值得 的 。 改 变 过 程 ， 让 团队 能 更 快 
地 完成 目标 ， 会 带 来 可 衡量 的 经 济 利益 ， 这 样 也 就 可 以 证 明 在 过 程 变 
革 中 的 投资 是 值得 的 了 。 

短 周期 的 迭代 或 者 基于 流程 的 开发 显著 提高 了 潜在 发 布 的 频率 。 
比方 说 ， 你 想 在 接 下 来 的 12 个 月 里 ， 发 布 12 个 版 本 (大 部 分 我 采访 的 
团队 会 发 布 2 倍 于 这 个 数字 的 版 本 ) ， 用 户 验收 测试 平均 需要 3 天 的 时 
间 。 这 意味 着 ， 在 未 来 的 1 年 里 ， 你 要 花 36 天 的 时 间 做 用 户 验 收 测 试 ， 
这 还 是 从 最 佳 情 况 考虑 : 没有 发 现任 何 问题 ， 软 件 总 是 被 客户 所 接 
Zo (但 如 果 这 样 ， 为 什么 还 要 人 花 3 天 的 时 间 去 测试 呢 ?) 实际 中 更 常 
遇 到 的 情况 是 : 验收 测试 放 到 最 后 才 去 做 ， 然 后 返工 ， 然 后 一 年 中 至 
少 再 花 上 两 个 月 的 时 间 重 新 进行 测试 。 

如 果 一 开始 就 与 其 他 人 协作 确定 验收 条 件 ， 并 实现 自动 化 验证 ， 
那么 你 就 不 必 滔 费时 间 去 手工 测试 及 返工 了 。 自 动 化 有 一 定 的 成 本 ， 
但 实例 化 需求 说 明 可 以 显著 减少 产品 上 市 所 需 的 时 间 。 

实例 化 需求 说 明 还 有 很 多 其 他 好 处 ， 但 这 一 点 是 最 容易 展现 给 商 
业 项 目 干系 人 看 的 ， 也 是 最 容易 量化 的 。 如 果 你 要 说 服 商 业 项 目 干 系 
人 接受 这 种 过 程 变更 ， 不 妨 试 着 把 它 能 使 产品 每 年 提前 两 个 月 投放 市 
场 作为 卖点 。 


在 我 采访 的 团队 中 ， 最 常见 的 早期 问题 之 一 是 他 们 把 功能 测试 自 
动 化 当成 了 过 程 变 更 的 最 终 目标 。 业 务 人 员 通 常会 认为 功能 测试 自动 
化 是 测试 相关 的 工作 ， 因 此 他 们 没 必 要 参与 进去 。 开 发 人 员 需 要 理 
解 ， 为 了 改善 沟通 ， 自 动 化 测试 应 该 是 人 们 可 以 读 懂 的 ， 否 则 他 们 在 
对 测试 进行 自动 化 的 时 候 ， 只 会 考虑 最 大 限度 地 减少 开发 的 工作 量 。 

-团队 只 关注 测试 自动 化 时 ， 就 不 会 更 好 地 协作 。 

这 种 方法 会 导致 测试 过 于 技术 化 ， 使 得 测试 只 是 一 些 脚本 ， 而 不 
是 需求 说 明 ， 这 是 一 种 常见 的 失败 模式 〈 详 见 8.3.2 节 ) 。 从 长 远 来 
看 ， 这 样 的 自动 化 测试 会 成 为 过 程 变更 的 障碍 ， 而 不 是 催化 剂 。 

如 果 你 把 功能 测试 自动 化 当成 实例 化 需求 说 明 的 一 个 步骤 ， 那 就 
要 让 团队 的 所 有 人 都 清楚 最 终 的 目标 是 什么 。 当 功能 测试 自动 化 站 住 
了 脚 ， 就 该 进行 下 一 步行 动 了 。 


4.2.5 六 -上 


我 采访 的 人 员 中 ， 有 3 位 一 开始 只 是 想 选 择 一 个 好 的 工具 。 有 些 开 
发 人 员 听 说 过 FitNesse 或 者 Cucumber， 然 后 他 们 决定 在 项 目 中 试 试 
看 。 这 种 错误 我 自己 也 犯 过 ， 但 这 种 做 法 成 功 的 机 会 不 大 。 

-实例 化 需求 说 明 并 不 以 程序 员 为 中 心 ， 而 程序 员 独 自 使 用 一 个 
工具 不 会 取得 很 好 的 效果 。 

这 种 方法 往往 会 导致 这 样 的 局 面 : 程序 员 想 实现 可 执行 的 需求 说 
明 ， 但 却 使 用 了 非 技 术 性 的 工具 ， 试 图 管理 技术 性 的 、 面 向 开发 人 员 
的 测试 。 这 无 疑 是 在 浪费 时 间 。 

在 开发 人 员 关 注 于 特定 工具 的 3 个 案例 中 ， 只 有 Ian cooper 的 团队 
成 功 建立 了 一 个 恨 好 的 过 程 ， 他 们 效力 于 Beazley 公 司 。 他 们 很 努力 地 
让 测试 人 员 和 业务 分 析 师 参与 进去 ， 接 着 调整 了 他 们 编写 和 组 织 测 试 
的 方式 。 同 时 ， 他 们 对 工具 带 来 的 好 处 精益 求 精 ， 并 寻找 更 简单 的 方 
法 来 获取 那些 好 处 。 

在 另外 两 个 案例 中 ， 团 队 过 分 关注 于 工具 ， 而 不 是 去 关注 高 层次 
的 协作 和 过 程 变更 。 最 终 ， 他 们 浪费 了 很 多 时 间 和 精力 ， 建 立 的 一 套 
技术 性 测试 方法 让 业务 人 员 和 测试 人 员 根 本 没 法 使 用 。 他 们 在 测试 维 
护 上 花费 了 非常 多 的 精力 和 时 间 ， 却 没有 从 实例 化 需求 说 明 中 得 到 任 
何 好 处 。 
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适用 于 : 在 遗留 系统 中 引入 功能 测试 自动 化 时 

使 用 新 的 工具 去 重 写 功能 测试 并 将 它们 自动 化 需要 一 定 的 时 间 。 
在 新 的 验证 系统 成 长 到 一 定 规 模 前 ， 现 有 的 测试 应 该 予以 维护 ， 并 使 
其 保持 更 新 。 解 决 这 个 问题 的 一 个 好 方法 是 : 在 做 近期 计划 时 ， 委 托 
一 个 人 专门 去 维护 并 更 新 老 的 测试 。 

James Shore 和 Shane Warden 在 《敏捷 开发 的 艺术 》 一 书 中 ， 把 
遗留 项 目的 过 程 变更 描述 成 < 蝙蝠 侠 ” 模 式 。 蝙 蝠 侠 是 一 个 专门 解决 紧 
急 问 题 、 修 正 重大 缺陷 的 人 ， 而 团队 的 其 他 成 员 则 继续 新 功能 的 开 
发 。Markus Girtner 采 用 过 这 种 方法 ， 逐 步 地 把 一 套 测 试 迁移 到 为 可 执 
行 需 求 说 明 而 设计 的 自动 化 工具 上 。 他 详细 介绍 了 他 的 经 验 : 


注释 : (DJames Shore 和 ShaneWarden，The Art of Agile 
Development(O’ReillyMedia, 2007). 


“ 当 我 们 从 基于 shell 脚 本 的 测试 过 渡 到 基于 FitNesse 的 测试 时 ， 起 
初 只 有 两 位 成 员 专 注 于 新 的 东西 上 ， 而 维护 遗留 测试 脚本 的 人 则 有 3 
个 。 随 着 时 间 的 推移 ， 我 们 有 越 来 越 多 的 测试 人 员 参 与 到 新 的 方法 
中 。 先 是 3 位 ， 然 后 又 加 1 位 。 最 后 ， 我 们 可 以 彻底 把 老 的 脚本 抛弃 
掉 。 

这 背后 的 思想 就 是 ‘蝙蝠 侠 ; 模 式 ， 他 只 管 解决 问题 。 我 记得 有 些 
同事 甚至 从 Hot Wheels 买 了 一 辆 玩具 车 一 一 蝙蝠 车 ， 并 将 它 交 给 了 我 
们 当时 的 “蝙蝠 使 '。 最 初 的 时 候 ， 我 就 有 过 让 大 家 轮流 当 蝙 蝠 使 的 想 
法 ,但 从 来 就 没 尝 试 过 ， 因 为 当时 我 的 同事 都 不 喜欢 分 享 知 识 。 现 在 
我 们 采用 了 这 种 新 的 方法 ， 我 试 着 让 大 家 轮换 担任 蝙蝠 侠 的 角色 ， 这 
样 在 过 渡 过 程 中 ， 每 个 人 都 可 以 接触 到 旧 的 东西 和 新 的 东西 。 让 每 个 
人 都 认同 新 的 做 法 是 至 关 重要 的 。>” 

-通过 委派 一 个 专门 的 人 员 来 更 新 遗留 事项 ， 团 队 就 可 以 更 快 地 
朝 着 迁移 到 新 过 程 的 目标 前 进 。 


这 个 想法 与 Alistair Cockburn 的 “牺牲 一 人 >”@ 策略 很 像 ， 留 一 个 人 
专门 处 理 让 人 分 心 的 任务 ， 其 余 成 员 全 速 前 进 。 


注释 : ~@http://alistair.cockburn.us/Sacrifice+one+perSon+strategy 
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适用 于 : 开发 人 员 都 不 愿意 参与 时 

当 开 发 人 员 有 很 强 的 结构 化 过 程 背 景 《程序 员 编写 代码 ， 测 试 人 
员 对 其 进行 测试 ) 时 ， 团 队 就 难以 让 程序 员 也 参与 到 过 程 中 。 为 了 让 
实例 化 需求 说 明 产 生 作 用 ， 这 一 点 必须 要 改变 。 

Pierre Veragen 有 一 个 独特 的 解决 方案 ， 可 以 让 程序 员 参 与 进来 。 
他 创建 了 一 个 简单 的 集中 化 的 报告 系统 ， 告 诉 他 可 执行 的 需求 说 明 在 
何 时 何 地 被 检查 过 : 

“在 Fixture 代 码 中 ， 我 放 入 了 一 点 小 东西 ， 它 告诉 我 人 们 什么 时 
候 在 他 们 的 机 器 上 运行 了 测试 。 那 个 小 组 的 成 员 都 有 点 儿 不 善 沟通 。 
我 用 这 种 方式 找 出 了 人 们 什么 时 候 没 有 运行 测试 ， 然 后 与 他 们 进行 
谈 ， 以 便 了 解 发 生 了 什么 问题 ， 看 他 们 是 否 遇 到 了 困难 。 这 种 做 法 是 
为 了 获取 更 加 客观 的 反馈 ， 而 不 是 一 句 “ 是 的 ， 它 运行 良好 '。” 

通过 跟踪 提交 前 谁 没 有 执行 测试 ， 他 能 够 集中 精力 去 帮助 那些 遇 
到 问题 或 者 需要 帮助 的 成 员 。Veragen 说 ， 由 于 所 有 程序 员 一 开始 就 了 
解 这 个 过 程 ， 因 此 他 只 跟踪 某 人 是 否 执行 了 测试 ， 而 不 是 监视 实际 的 
测试 结果 。 

-通过 监视 测试 是 否 执行 ， 来 让 程序 员 执 行 自 动 检查 程序 。 

在 较 大 的 团队 里 ， 教 练 无 法 总 是 与 所 有 成 员 一 起 工作 ， 因 此 这 是 
一 种 有 趣 的 方法 。 我 估计 这 种 方法 的 效果 与 公布 高 速 公 路 上 高 速 摄像 
机 的 位 置 有 点 类 似 一 一 程序 员 知 道 有 人 在 盯 着 ， 因 而 他 们 运行 检查 程 
序 时 会 更 加 仔细 。 


当 团 队 开始 实施 实例 化 需求 说 明 时 ， 其 中 一 个 最 大 的 挑战 是 理解 

如 何 将 协作 融入 到 交付 周期 中 。 
实例 化 需求 说 明和 瀑布 式 分 析 的 区 别 

我 在 大 会 上 遇 到 的 很 多 人 都 误 以 为 增 量 地 建立 一 个 文档 系统 意味 
着 回 到 瀑布 式 的 思想 ， 需 要 做 大 量 的 前 期 分 析 。2009 年 11 月 ，Dan 
North 在 他 的 演讲 “如 何 将 BDD 推 销 给 业务 人 员 ”o 中 说 ，BDD 实 际 上 
是 压缩 到 两 周 的 V 模 型 。 虽 然 这 种 描述 并 不 完全 准确 ， 但 它 是 一 个 良 
好 的 开端 。 


注释 : (Dhttp://skillsmatter.com/podcast/agile-testing/how-to-sell-bdd- 
to-the-business 


瀑布 式 分 析 的 方法 与 实例 化 需求 说 明 试图 实现 的 东西 有 一 些 本 质 
区 别 。 理 解 这 些 基本 原则 很 重要 ， 因 为 它们 有 助 于 你 把 这 些 实 践 融入 
到 自己 的 过 程 中 ， 无 论 你 的 过 程 是 什么 样子 的 。 以 下 这 些 是 实例 化 需 
求 说 明 区 别 于 规划 性 分 析 方 式 的 关键 因素 。 

通过 快速 周转 来 提供 快速 反馈 和 重点 ; 高 效 地 完成 软件 的 一 小 
块 ， 而 不 是 试图 一 次 性 处 理 一 大 块 。 

强调 有 效 、 高 效 的 沟通 ， 而 不 是 元 长 、 乏 味 的 文档 。 

建立 共享 所 有 权 ， 这 样 在 需求 说 明 变 成 代码 或 测试 的 过 程 中 ， 
发 人 员 与 测试 人 员 不 会 互 不 通气 。 

整合 跨 职能 团队 ， 为 了 制定 正确 的 系统 需求 ， 测 试 人 员 、 分 析 师 
A EET; 而 非 各 自 为 战 。 

过 程 变 更 没有 通用 的 解决 方案 ， 每 个 团队 都 需要 决定 如 何 最 好 地 
扩展 他 们 交付 软件 的 方式 。 igh Ee i 性 的 例子 ， 帮 
助 你 开始 着 手 变革 。 我 挑选 了 3 个 很 好 的 案例 研究 ， 每 一 个 都 代表 一 种 
受 欢迎 的 过 程 。Global Talent Management 团 队 采 用 pe 的 看 板 框 
架 ，Sierra 团 队 使 用 基于 迭代 的 极限 编程 过 程 来 交付 软件 ， 而 Sky 
Network Services 集 团 基 于 Scrum 进 行 迭代 。 


4.3.1 Ultimate 软件 公司 的 Global Talent Management 团 队 


Ultimate 软件 公司 有 一 个 人 力 资源 管理 系统 ， 该 系统 拥有 16 组 团 
队 ，Global Talent Management 团 队 是 其 中 之 一 。 该 团队 由 一 名 产品 负 
责 人 、 一 位 用 户 体验 专家 、4 名 测试 人 员 和 10 名 开发 人 员 组 成 。 当 我 采 
访 该 团队 的 Scott Berger 和 Maykel Suarez 时 ， 他 们 的 项 目 已 经 开展 了 8 个 
月 。 那 个 团队 使 用 的 是 看 板 的 工作 流 过 程 。 

由 于 产品 分 析 师 (兼作 分 析 师 和 产品 负责 人 ) RIL, ANES 
协作 制定 需求 说 明 时 ， 试 图 更 有 效率 地 利用 他 的 时 间 。 产 品 分 析 师 使 
用 “故事 点 ”在 更 宏观 的 层次 上 解释 一 个 故事 【在 他 们 这 个 案例 中 ， 故 
事 点 指 的 不 是 复杂 度 的 估计 ， 而 是 解释 故事 的 列表 项 ) 。 编 写 故 事 点 
时 ， 他 们 尽量 避免 使 用 技术 专用 语言 。 然 后 该 故事 就 被 添加 到 看 板 上 
当 作 功能 清单 的 一 部 分 。 

每 日 例会 限制 在 30 分 钟 之 内 ， 首 席 工程 师 、 产 品 分 析 师 以 及 团队 
里 任何 对 功能 清单 感 兴 趣 的 人 一 同 参加 会 议 。 他 们 快速 地 过 一 遍 产 品 
清单 上 的 故事 ， 检 查 每 个 故事 是 否 被 正确 地 分 割 、 是 否 讲 得 通 、 是 否 
可 以 由 一 个 团队 在 4 天 之 内 完成 一 一 这 是 他 们 为 每 个 故事 设 定 的 期 限 。 
在 会 议 上 ， 他 们 还 会 去 理 清 没 有 解决 的 问题 ， 盘 点 故事 的 依赖 项 。 

之 后 ， 故 事 就 进入 了 等 待 编 写实 例 化 需求 说 明 的 队列 ， 它 们 也 被 
用 作 验 收 测试 。 将 要 实现 该 故事 的 人 与 测试 该 故事 的 人 一 起 结对 ， 编 
写 这 些 需求 说 明 的 概要 。 (他 们 在 团队 中 没有 正式 的 测试 人 员 角 色 和 
开发 人 员 角 色 ， 但 是 为 了 方便 起 见 ， 在 本 小 节 里 ， 我 将 使 用 这 两 个 角 
色 来 指 代 结对 的 这 两 个 人 。) Berger 解 释 说 : 

“通过 这 种 结对 ， 我 们 能 够 减少 这 个 故事 所 需 的 测试 ， 因 为 开发 人 
员 对 代码 更 为 熟悉 。 事 实证 明 这 种 做 法 相当 成 功 ， 因 为 在 最 初 的 故事 
审核 中 ， 可 能 会 遗漏 一 些 不 一 致 的 地 方 以 及 设计 缺陷 ， 而 这 种 结对 则 
可 以 有 效 消 除 这 种 问题 。” 

他 们 定义 好 大 纲 概 要 之 后 ， 测 试 人 员 通 常 以 Given-When-Then 的 
格式 来 完成 各 种 场景 。 结 对 的 两 个 人 和 产品 分 析 师 在 一 个 深度 “故事 知 
识 和 信息 传递 ”"(SKIT) 的 会 议 上 审核 这 些 场 景 。 用 这 种 做 法 ， 万 一 分 析 
师 不 在 场 ， 程 序 员 和 测试 人 员 也 可 以 写 出 良好 的 需求 说 明 。 产 品 分 析 


师 审核 过 这 些 场 景 后 ， ee 
少数 的 文字 修正 ， 不 允许 再 对 这 些 需 求 做 变 

te eee 
这 让 测试 人 员 可 以 有 更 多 的 时 间 去 完成 探索 性 测试 。 虽 然 测 试 人 员 可 
能 也 会 去 编写 目 动 化 场景 ， 但 这 不 再 是 他 们 的 工作 重点 。Berger 说 这 
样 的 协作 使 得 他 们 可 以 高 效 地 工作 : 

“在 自动 化 方面 ， 熟 悉 代 码 的 开发 人 员 会 更 快 ， 事实 上 他 们 编写 的 
自动 化 代码 可 以 直接 访问 他 们 自己 编写 的 对 象 (而 不 是 通过 用 户 界面 
来 自动 化 ) ， 而 且 由 于 很 多 错误 条 件 和 组 舍 都 明确 描述 了 ， 所 以 他 们 
在 开发 过 程 中 可 以 获得 更 多 益处 。 由 于 我 们 是 在 图 形 用 户 界 面 之 下 进 
行 测试 的 ， 所 以 测试 执行 得 更 快 更 稳定 。 测 试 人 员 也 可 以 花 更 多 的 时 
间 来 执行 程序 代码 并 提供 反馈 。” 

在 开发 阶段 结束 前 ， 所 有 的 可 执行 需求 说 明 都 必须 运行 通过 。 在 
运行 测试 阶段 会 集成 其 他 团队 的 工作 ， 所 有 的 测试 将 再 次 运行 。 而 在 
等 待 审 核 阶段 ， 团 队 要 给 产品 分 析 师 做 一 个 快速 的 产品 演示 ， 让 他 验 
收 。 

据 Berger 说 ， 这 个 过 程 产生 了 非常 高 质量 的 结果 : 

“通过 和 产品 分 析 师 的 密切 舍 作 ， 并 将 测试 作为 需求 的 基础 ， 我 们 
能 够 实现 非常 高 的 质量 。 业 务 人 员 采 集 了 许多 度量 指标 ， 其 中 一 个 指 
标 我 认为 很 好 地 说 明了 我 们 在 提升 质量 方面 的 努力 ， 那 就 是 缺陷 检测 
效率 (IDDE，Defect Detection Efficiency)。 我 们 Global Talent 
Management 团 队 的 DDE 是 99% (2010 年 第 1 季度 到 第 3 季度 ) ! ” 


4.3.2 BNP Paribas 银 行 的 Sierra 


BNP Paribas 银 行 的 Sierra 团 队 在 开发 一 个 后 台 参 考 数 据 管理 和 分 配 
系统 。 团 队 由 8 名 开发 人 员 、2 个 业务 分 析 师 和 1 个 项 目 经 理 组 成 。 因 为 
没有 专门 的 测试 人 员 ， 所 以 团队 里 每 个 人 都 需要 负责 测试 。 他 们 的 项 
目 干 系 人 是 不 在 现场 的 商业 用 户 。 变 更 需求 通常 需要 大 量 的 分 析 ， 要 
与 项 目 干 系 人 协作 。 


项 目 已 经 进行 了 大 约 5 年 的 时 间 ， 所 以 已 经 相当 成 熟 ， 并 且 业 务 分 
析 师 拥有 很 多 现成 的 可 执行 需求 说 明 ， 可 以 当 作 例子 来 使 用 。Andrew 
Jackman 曾 经 是 该 团队 的 一 员 ， 当 我 采访 他 时 ， 他 说 这 是 一 个 金融 服务 
行业 里 的 罕见 例子 ， 他 们 几乎 完全 遵照 规范 来 应 用 极限 编程 。 

他 们 的 开发 过 程 始 于 项 目 经 理 ， 项 目 经 理事 先 为 迭代 挑选 一 些 故 
事 。 在 迭代 开始 之 前 ， 业 务 分 析 师 同 远 程 的 项 目 干 系 人 一 起 工作 ， 准 
备 详细 的 验收 条 件 。 他 们 使 用 现 有 需求 说 明 的 实例 来 驱动 新 需求 说 明 
的 结构 。 如 果 新 的 需求 说 明 与 现 有 的 任何 一 个 需求 说 明 都 有 显著 的 不 
同 ， 那 么 结对 的 两 个 开发 人 员 将 对 测试 进行 审核 ， 以 便 提供 早期 的 反 
馈 并 确定 相关 测试 可 以 被 自动 化 。 

他 们 的 迭代 是 两 周一 轮 ， 始 于 第 二 周 的 礼拜 三 。 当 迭代 开始 时 ， 
整个 团队 聚 在 一 起 开 计 划 会 议 ， 并 按照 优先 级 来 审核 本 次 迭代 将 要 完 
成 的 故事 。 会 议 目的 是 为 了 保证 所 有 的 开发 人 员 都 能 理解 故事 的 内 
容 ， 估 算 故 事 的 大 小 ， 并 检查 技术 依赖 项 ， 看 是 否 可 能 进一步 改善 交 
付 顺 序 。 他 们 还 会 将 故事 分 割 成 开发 任务 。 当 故事 在 计划 会 议 里 进行 
审核 的 时 候 ， 该 故事 的 验收 条 件 通常 已 经 确定 好 了 。 

团队 偶尔 会 发 现 某 个 故事 不 是 很 好 理解 。 如 果 他 们 采用 的 迭代 有 周 
期 是 一 周 ， 此 类 故事 可 能 会 破坏 流程 ， 但 是 两 周 长 的 迭代 周期 则 可 以 
让 他 们 处 理 这 种 状况 ， 而 不 会 对 整体 流程 审 来 多 大 的 影响 。 

接着 ， 开 发 人 员 以 结对 的 方式 来 实现 这 些 故事 。 在 结对 的 两 个 开 
发 人 员 完 成 一 个 故事 并 通过 所 有 相关 的 测试 后 ， 业 务 分 析 师 将 花 些 时 
间 去 做 探索 性 测试 。 如 果 分 析 师 发 现 意 外 的 行为 ， 或 者 他 意识 到 团队 
没有 完全 理解 某 个 故事 对 系统 带 来 的 影响 ， 那 么 他 将 使 用 相关 的 实例 
来 扩展 需求 说 明 ， 并 把 该 故事 返回 给 开发 人 员 。 

4.3.3 Z 部 | 

英国 天 空 广播 公司 的 天 空 网 络 服务 部 门 在 维护 一 个 宽带 的 配置 供 
应 系统 。 该 部 门 由 6 个 团队 组 成 ， 每 个 团队 有 五 六 个 开发 人 员 和 一 两 个 
测试 人 员 。 整 个 部 门 共享 6 名 业务 分 析 师 。 由 于 团队 单独 维护 不 同 成 熟 
度 的 功能 组 件 ， 所 以 每 个 团队 的 流程 略 有 不 同 。 


整个 部 门 使 用 的 是 基于 Scrum 的 过 程 ， 迭 代 周 期 是 两 周 。 在 一 轮 
迭代 正式 开始 的 前 一 周 ， 他 们 会 组 织 一 个 预先 计划 协调 会 议 ， 每 个 团 
队 抽 出 两 三 个 人 参加 。 该 会 议 的 目的 是 为 故事 排列 优先 顺序 。 当 他 们 
ee 
条 件 。 在 会 议 之 后 ， 测 试 人 员 将 开始 编写 带 实例 的 需求 说 明 ， 这 通常 
ee 
一 两 个 故事 ， 各 自 带 有 已 经 做 好 自动 化 准备 的 、 详 细 的 、 带 实例 的 需 
求 说 明 。 

迭代 从 第 二 周 的 周三 开始 ， 最 初 会 有 一 个 跨 团队 的 计划 会 议 ， 让 
每 个 人 都 了 解 整体 的 进度 以 及 这 轮 迁 代 的 商业 目标 。 然 后 每 个 团队 间 
独 召 开 计划 会 议 。 某 些 团队 只 花 15 分 钟 简要 地 浏览 一 下 所 有 的 故事 ， 
而 有 些 团 队 则 要 花 上 几 个 小 时 来 研究 细节 。Rakesh Patel 是 该 项 目的 一 
名 开发 人 员 ， 他 说 这 主要 取决 于 底层 组 件 的 成 熟 度 : 

“ 当 我 们 接手 的 工作 涉及 一 个 存在 很 久 的 组 件 ， 而 我 们 只 是 为 它 增 
加 一 些 消息 时 ， 对 整个 团队 来 说 ， 在 选择 该 故事 卡 进行 工作 之 前 ， 没 
必要 让 每 个 人 都 知道 它 涉及 什么 内 容 。 而 有 些 团队 正在 开发 一 个 新 的 
图 形 用 户 界 面 ， 面 对 全 新 的 功能 ， 这 时 可 能 更 舍 适 让 整个 团队 坐 下 来 
深入 讨论 并 规划 需要 完成 的 内 容 。 在 这 个 时 候 ， 我 们 可 能 还 会 讨论 一 
些 非 功 能 性 的 需求 、 架 构 等 。” 

在 计划 会 议 之 后 ， 开 发 人 员 开 始 对 那些 已 经 有 实例 化 需求 说 明 的 
故事 展开 工作 。 业 务 分 析 师 和 测试 人 员 针 对 当前 迭代 里 计划 的 所 有 故 
事 编写 验收 条 件 。 一 旦 完成 某 个 故事 的 需求 说 明 ， 他 们 就 与 指定 的 “ 故 
事 负责 人 ”( 详 见 后 文 ) 开 会 并 仔细 检查 所 有 测试 。 如 果 每 个 人 都 觉得 
完成 某 个 故事 所 需 的 信息 已 经 足够 ， 那 就 给 那 张 故事 卡 贴 上 一 张 族 
的 贴纸 ， 表 明 那 个 故事 可 以 进行 开发 了 。 

开发 完成 后 ， 业 务 分 析 师 将 再 次 审核 需求 说 明 ， 并 在 卡片 上 贴 一 
张 红 色 的 贴纸 。 然 后 ， 测 试 人 员 对 故事 运行 一 些 额外 的 测试 ， 当 测试 
ee 
队 、 数 据 库 管 理 员 或 系统 管理 员 的 审核 。 审 核 之 后 ， 数 据 库 管 理 员 给 


故事 卡 贴 的 是 一 个 金星 ， 系 统管 理 员 贴 的 是 银 星 。 贴 纸 可 以 确保 所 有 
涉及 该 故事 的 人 员 都 对 目前 的 状况 一 目 了 然 。 

SNS 团 队 没有 组 织 大 型 的 需求 说 明 会 议 ， 他 们 组 织 的 是 一 个 流 过 
程 。 他 们 使 用 的 需求 说 明 制 定 过 程 依然 有 两 个 阶段 : 业务 分 析 师 和 测 
试 人 员 对 所 有 实例 进行 前 期 准备 ， 然 后 与 开发 人 员 一 起 进行 审核 。 这 
让 开发 人 员 有 更 多 的 时 间 去 关注 开发 工作 。 故 事 负责 人 在 与 其 他 开发 
人 员 结 对 的 过 程 中 负责 有 效 地 传递 信息 ， 而 不 需要 让 所 有 开发 人 员 都 
参与 审核 来 确保 他 们 理解 故事 。 

前 面 3 个 例子 展示 了 团队 如 何 将 协作 融入 短 迭 代 甚 至 基于 流 的 过 程 
中 ， 证 明了 没有 通用 和 全 局 适用 的 方法 来 将 过 程 结构 化 。 所 有 团队 都 
成 功 地 将 协作 集成 到 他 们 自己 的 短发 布 周期 中 ， 但 是 根据 团队 结构 、 
商业 用 户 的 参与 性 以 及 变更 进入 交付 流程 的 复杂 性 等 的 不 同 ， 他 们 使 
用 的 方法 也 不 尽 相 同 。 

故事 负责 人 (Story Champion) 

SNS 团 队 在 轮换 故事 的 结对 开发 人 员 时 ， 采 用 了 故事 负责 人 来 确 
保 信 息 的 有 效 传递 。Kumaran Sivapathasuntharam 是 该 项 目的 业务 分 
析 师 ， 他 说 : 

“故事 会 分 配给 某 个 特定 的 开发 人 员 ， 他 会 坚持 到 该 故事 完成 。 这 
确保 了 每 个 故事 都 有 一 个 联络 人 一 一 这 样 当 故 事 出 现 问 题 时 ， 可 以 找 
该 故事 的 负责 人 进行 谈话 。 一 个 人 从 故事 的 开始 坚持 到 结束 ， 这 样 结 
对 的 两 个 人 不 会 都 被 它 所 率 绊 ， 他 们 可 以 不 断 改变 结 对 的 人 员 而 仍然 
自始至终 保持 连续 性 。>” 

Ultimate 软件 公司 的 Global Talent Management 团 队 有 一 个 类 似 的 
角色 ， 他 们 称 之 为 故事 担保 人 (story sponsor)。 据 Maykel Suarez 所 
述 ， 担 保 人 负责 与 其 他 团队 进行 沟通 、 在 看 板 上 跟踪 进度 、 在 每 日 例 
会 上 检查 状态 以 及 清除 障碍 。 


4.4 处 理 签收 和 可 追溯 性 


对 有 些 团 队 来 说 ， 敏 捷 项 目 没 有 文档 或 只 有 少量 文档 所 市 来 的 一 
个 主要 问题 是 需求 的 缺乏 。 这 使 得 签收 需求 或 交付 变 得 很 困难 。 整 体 
上 来 看 ， 软 件 开 发 行业 远 不 如 十 年 前 关注 签收 。 有 些 情况 下 ， 由 于 监 
管 约束 或 商业 安排 ， 签 收 还 是 需要 的 。 

实例 化 需求 说 明 提供 了 有 关 需 求 的 工件 : 活 文档 。 活 文档 可 用 于 
追溯 ， 这 使 得 敏捷 过 程 可 以 应 用 于 受 管 制 的 行业 。Bas Vodde 和 Craig 
Larman 在 Practices for Scaling Lean and Agile 一 书 中 提 到 了 美国 核 工业 
的 第 一 个 敏捷 开发 项 目 ") 。 那 个 项 目的 团队 使 用 了 可 执行 的 需求 说 明 
以 确保 需求 完全 可 追溯 ， 这 在 核 领域 和 其 他 对 安全 要 求 十 分 苛刻 的 领 
域 是 非常 重要 的 。 另 一 方面 ， 由 于 使 用 了 高 动态 的 、 迭 代 的 协作 方式 
来 产生 这 些 工 件 ， 前 期 签收 几乎 是 不 可 能 的 。 下 面 是 一 些 如 何 处 理 签 
收 和 可 追溯 性 约束 的 方法 。 


注释 : 我 也 很 想 把 这 个 案例 研究 加 入 到 本 书 中 ， 但 不 六 的 是 ， 
我 没 能 找到 任何 愿意 和 我 谈 谈 这 个 项 目的 人 。 


4.4.1 NFA AAT RI 


~ 我 访问 过 的 一 些 人 说 ， 把 可 执行 需求 说 明和 产品 代码 放 在 同一 
个 版 本 控制 系统 中 ， 是 成 功 实施 过 程 的 最 重要 的 做 法 之 一 。 

许多 自动 化 工具 支持 纯 文本 文件 的 可 执行 需求 说 明 ， 所 以 它们 同 
样 也 支持 版 本 控制 系统 。 因 此 你 可 以 很 容易 地 对 需求 说 明和 源 代码 做 
标签 (tag) 和 分 支 (branch)。 这 样 你 可 以 获得 测试 的 最 新 以 及 正确 版 本 ， 
用 以 验证 产品 的 不 同 版 本 。 

版 本 控制 系统 有 很 高 的 可 追溯 性 ， 因 为 它们 让 你 可 以 瞬间 找到 什 
么 人 在 什么 时 候 出 于 什么 原因 修改 了 哪个 文件 。 如 果 把 可 执行 需求 说 
明 保 存在 版 本 控制 系统 中 ， 那 么 将 能 轻易 追溯 到 需求 和 需求 说 明 。 通 
过 实例 化 需求 说 明 ， 可 执行 需求 说 明 将 直接 和 程序 代码 联系 在 一 起 
(通过 自动 化 层 ) ， 这 意味 着 代码 也 具备 可 追溯 性 。 


与 那些 保存 在 单独 的 需求 或 测试 工具 中 的 需求 说 明 相 比 ， 版 本 控 
制 系统 中 的 可 执行 需求 说 明 更 不 容易 丢失 。 
4.4.2 通过 等 


适用 于 : 逐个 迭代 签收 

实例 化 需求 说 明 应 当 有 助 于 在 项 目 出 资 人 和 交付 团队 之 间 建 立信 
任 ， 并 免除 签收 的 过 程 。 如 果 确 实 因为 一 些 商业 或 政治 原因 需要 签收 
需求 ， 那 么 你 可 以 使 用 活 文档 系统 。 

~ 如果 需 要 在 实现 功能 前 签收 需求 说 明 ， 并 且 可 以 在 每 个 迭代 里 
都 这 么 做 ， 那 么 你 可 以 根据 下 一 个 迭代 所 计划 的 可 执行 需求 文档 创建 
一 个 word 或 PDF 文档 ， 然 后 在 上 面 签收 。 

有 些 上 自动 化 工具 ， 比 如 Cucumber， 支 持 直 接 导 出 为 PDF， 这 可 能 
对 等 收 过 程 有 所 帮助 。 


4.4.3 签收 的 是 范围 ， 而 非 需 求 说 明 


适用 于 : 签收 较 长 的 里 程 碑 

> 如果 你 要 签收 的 内 容 比 一 个 迭代 所 能 交付 的 要 大 ， 那 就 试 着 对 
沁 围 而 非 对 具体 的 需求 说 明 进 行 签收 。 比 方 说 ， 签 收 用 尸 故 事 或 用 
例 。 

Rob Park 在 为 一 家 美国 大 型 保险 公司 工作 时 使 用 了 这 个 方法 。 他 
的 团队 签收 时 保持 着 瀑布 式 的 审批 过 程 ， 但 显著 地 减少 了 需要 签收 的 
材料 。Park 解 释 道 : 

“在 我 们 所 能 控制 的 事情 之 外 还 有 一 个 更 大 的 过 程 。 业 务 分 析 师 使 
用 带 模板 的 Word 文 档 ， 但 是 他 们 把 模板 从 8 页 减少 到 了 2 页 。 有 一 个 故 
事 卡 审批 过 程 ， 项 目的 出 资 人 在 只 有 业务 分 析 师 看 过 故事 卡 的 情况 下 
就 签收 了 。 所 以 他 们 只 在 公司 的 高 层级 里 使 用 这 个 瀑布 过 程 ， 而 一 旦 
进入 到 团队 就 是 另 一 回 事 了 。” 

在 这 个 案例 中 ， 使 用 word 文 档 纯粹 是 因为 合同 规定 了 一 个 故事 进 
入 开发 前 需要 文书 工作 。 在 范围 获得 审批 后 ， 团 队 使 用 可 执行 需求 说 
明 作 为 他 们 唯一 的 需求 来 产 。 


4.4.4 在 “ ”上 签 


适用 于 : 受 监 管 的 签收 需要 详细 的 内 容 时 

在 严格 的 监管 环境 中 对 范围 进行 签收 可 能 是 不 太 现 实 的 。 来 自 
Knowledgent Group 的 Mike Vogel 曾 在 一 个 医药 工业 的 项 目 中 工作 过 ， 
他 们 使 用 的 过 程 是 基于 Scrum 和 XP 的 扩展 ， 以 便 满足 监管 需求 。 他 的 
团队 使 用 用 例 ， 因 为 单独 使 用 用 户 故 事 不 能 达到 监管 系统 的 标准 。 

团队 使 用 精简 的 用 例 (他 们 称 作 “ 结 构 化 的 故事 *”) ， 这 样 最 初 的 
捕获 和 持续 演化 就 不 是 个 大 问题 。 那 些 用 例 避 免 使 用 关于 数据 和 决策 
的 大 多 数 细节 (这 些 被 抽取 到 单独 的 数据 部 分 ) 。Vogel 解 释 了 这 个 方 
法 : 

“在 一 个 用 例 中 ， 你 需要 为 每 一 块 数据 起 一 个 名 字 ， 客 户 会 将 它 理 
解 为 领域 语言 的 一 部 分 。 数 据 块 的 描述 给 出 了 结构 和 规则 ， 其 描述 的 
是 数据 一 一 而 非 实例 。 实 例 是 在 (验收) 测试 /实例 化 需求 中 ， 我 们 通 
过 用 例 构建 实例 ， 这 些 实例 覆盖 并 展示 了 所 命名 的 数据 块 的 所 有 可 能 
变化 。 你 根据 他 们 提取 出 来 的 数据 块 变化 实例 。” 

= 对 “更 轻 量 的 用 例 ” 做 签收 ， 而 无 需 实例 。 

Vogel 的 团队 用 这 些 轻 量 的 用 例 构 建 了 需求 文档 ， 但 不 包含 任何 实 
例 。 其 结果 是 一 个 大 型 项 目的 文档 只 有 不 到 100 页 ， 按 Vogel 的 说 法 ， 
还 “使 用 了 所 有 监管 要 求 的 模板 ”。 整 个 项 目 中 ， 他 们 与 客户 协作 ， 共 
同 说 明了 用 例 和 实例 : 

“我 们 和 客户 一 起 坐 在 团队 房间 里 ， 尝 试 每 次 写 出 一 个 附带 实例 的 
用 例 。 讨 论 是 围绕 着 具体 的 实例 进行 的 。 我 们 最 终 会 加 入 一 些 细节 ， 
并 且 客 户 还 会 审查 。” 

团队 通过 这 个 方法 可 以 在 一 些 东 西 上 完成 签收 ， 这 些 东西 非常 像 
传统 的 需求 说 明 ， 但 又 不 会 太 过 细节 。 客 户 使 用 的 列表 是 基于 高 层次 
的 用 例 ， 而 细节 是 后 来 在 迭代 和 协作 过 程 进一步 充实 的 。 


4.4.5 现 


适用 于 : 签收 时 需要 所 有 的 细节 时 

Matthew Steer 参 与 过 一 些 基于 结构 化 过 程 (统一 软件 开发 过 程 ) 
的 项 目 。 该 过程 要 求 对 所 有 的 细节 进行 签收 ， 需 求 说 明 被 捕获 成 用 
例 。 另 外 ，Steer 和 他 的 团队 还 引入 了 用 例 实 现 ， 它 通过 实例 有 效 地 演 
示 了 有 用例。 这 使 他 们 能 够 在 结构 化 过 程 中 使 用 实例 化 需求 说 明 。Steer 
说 : 

“需求 被 捕获 成 用 例 和 额外 的 非 功 能 性 需求 的 需求 说 明 ， 用 法 非常 
传统 ， 照 章 办 事 地 捕获 。 通 过 用 例 ， 我 们 生成 了 用 例 实 现 、 实 例 以 及 
用 例 执行 的 场景 。 我 们 用 很 多 参数 创建 表格 并 与 数据 相关 联 ， 而 后 通 
过 流程 图 来 显示 如 何 实现 用 例 。 通 过 使 用 真实 的 场景 ， 用 例 实 现 就 变 
成 了 商业 意图 的 一 个 可 用 的 版 本 。” 

= 在 方法 论 雷 达 监 控 之 下 ， 添 加 诸如 用 例 实现 的 细节 是 在 正规 过 
程 中 引入 实例 化 需求 说 明 的 一 个 不 错 的 想法 。 当 商业 舍 同 需要 对 需求 
进行 签收 但 还 允许 之 后 对 细节 进行 变更 时 ， 这 种 做 法 同样 有 助 于 实现 
实例 化 需求 说 明 的 概念 。 


Steer 的 团队 和 之 前 提 到 的 其 他 团队 一 样 ， 使 用 实例 (即便 它 伪 装 
成 用 例 实现 ) 而 不 是 只 使 用 用 例 或 针对 更 通用 的 需求 制定 的 测试 。 这 
使 得 他 们 的 交付 过 程 更 加 有 效 。 

从 技术 上 来 说 ， 活 文档 系统 能 立刻 提供 需求 变更 的 可 追溯 性 ， 因 
为 团队 使 用 版 本 控制 系统 保存 可 执行 的 需求 说 明 。 迭 代 开 发 和 预先 等 
收 通常 是 冲突 的 ， 但 是 当 过 程 进行 了 变更 并 且 交 付 团 队 受 到 商业 用 户 
信任 的 时 候 ， 你 可 以 使 用 本 节 的 技巧 来 应 对 这 一 冲突 。 活 文档 系统 提 
供 的 透明 度 以 及 各 方 协作 制定 需求 说 明 ， 都 有 助 于 消除 签收 的 必要 


你 可 以 跟踪 自己 的 进度 ， 检 查实 例 化 需求 说 明 实 施 得 是 否 恰当 。 
对 于 任何 指标 ， 要 确保 指标 本 身 不 要 成 为 目标 ， 否 则 的 话 ， 你 可 能 会 
对 过 程 进 行 局 部 优化 以 便 达 到 某 个 指标 ， 而 不 顾 这 会 伤害 长 期 的 结 
果 。 使 用 指标 作为 度量 标准 ， 检 查 是 否 需要 对 过 程 作 出 调整 。 

4.5.1 注意 频繁 改动 的 测试 

在 2009 年 的 极限 编程 日 上 ，Mark Striebeck 谈 到 了 Google 为 了 推进 
他 们 的 测试 实践 所 做 的 事情 。D 让 我 印象 深刻 的 一 个 观点 是 ， 他 们 如 
何 衡量 某 个 (单元 ) 测试 的 恨 芜 。 当 某 个 测试 失败 时 ， 他 们 会 跟踪 源 
代码 的 改动 ， 直 到 测试 重新 通过 。 如 果 后 台 的 代码 更 改 了 ， 他 们 会 认 
为 那个 测试 是 一 个 恨 好 的 测试 。 如 果 测 试 更 新 了 而 源 代 码 没 有 更 新 ， 
他 们 会 认为 那 是 一 个 不 好 的 测试 。 通 过 搜集 这 些 统计 数据 ， 他 们 希望 
分 析出 单元 测试 的 模式 ， 确 定 什 么 因素 会 影响 一 个 测试 的 好 坏 。 


注释 : (Dhttp://gojko.net/2009/12/07/improving-testing-practices-at- 
google 

我 相信 相同 的 标准 同样 适用 于 可 执行 的 需求 说 明 。 如 果 某 个 验证 
失败 ， 你 更 改 了 代码 ， 那 就 说 明 你 发 现 并 修正 了 一 个 问题 。 如 果 某 个 


验证 失败 ， 而 你 不 得 不 更 改 需求 说 明 ， 那 就 代表 需求 说 明 编 写 得 不 太 
恰当 。 

业务 规则 应 该 比 实现 它们 的 技术 要 稳定 得 多 。 要 注意 频繁 更 改 的 
可 执行 需求 说 明 ， 我 们 要 寻找 好 的 方法 将 它们 编写 得 更 好 。 

你 也 可 以 统计 你 的 团队 为 让 问题 保持 在 可 控 的 范围 内 而 人 花费 在 重 
构 需 求 说 明 以 及 相关 自动 化 代码 上 的 时 间 。 如 果 你 在 迭代 中 要 花费 很 
多 时 间 来 做 这 件 事情 ， 那 就 去 寻找 更 好 的 方法 来 做 自动 化 测试 吧 (请 
参考 第 9 章 ， 那 里 有 一 些 很 好 的 提示 ) o 


4.5.2 当心 回 退 


检查 是 否 做 错 了 什么 ， 有 另外 一 个 很 好 的 指标 ， 那 就 是 检查 回 退 
的 出 现 。 回 退 是 指 一 个 故事 或 者 产品 功能 清单 中 的 项 目 ， 在 发 布 后 不 
到 一 个 月 的 时 间 内 又 返回 到 项 目 过 程 中 。 团 队 认 为 已 经 完成 了 ， 但 事 
实 上 仍 需 要 返工 。 不 过 ， 将 来 出 于 业务 需要 对 产品 进行 创新 、 演 进 ， 
而 对 现 有 的 需求 进行 扩展 ， 这 就 不 属于 回 退 。 

一 旦 实施 实例 化 需求 说 明 ， 回 退出 现 的 次 数 应 当 会 显著 减少 ， 直 
至 鲜 有 发 生 。 协 作 制 定 需求 说 明 以 及 测试 与 开发 更 好 的 结合 ， 应 该 可 
以 消除 由 于 误解 造成 的 返工 。 回 顾 几 个 月 回 退 的 趋势 ， 可 以 让 你 了 解 
你 们 改善 了 多 少 。 如 果 比 率 不 降 ， 那 就 说 明 实 施 过 程 的 方法 有 些 问 
题 。 

跟 蹊 回 退 不 需要 很 多 时 间 ， 通 单 每 轮 迭 代 化 上 几 分 钟 惑 可 以 了 ， 
但 当 遇 到 了 挑战 ， 或 者 需要 证 明 实 例 化 需求 说 明 执 行 良 好 时 ， 它 都 是 
非常 有 帮助 的 。 在 规模 较 大 的 公司 里 ， 它 也 可 以 提供 令 人 信服 的 证 
据 ， 表 明 实 例 化 需求 说 明 是 很 值得 其 他 团队 去 实施 的 。 对 于 更 复杂 的 
统计 ， 也 可 以 跟 踊 花 费 在 回 退 问题 上 的 时 间 ， 因 为 这 个 数字 直接 体现 
出 浪费 在 开发 或 者 测试 上 的 时 间 和 人 金钱。 如果 大 家 抱怨 人 花费 在 自动 化 
可 执行 需求 说 明 上 的 时 间 是 不 必要 的 开销 ， 那 束 比 较 一 下 几 个 月 前 他 
们 花费 在 回 退 上 的 时 间 。 据 此 建立 起 一 个 实施 实例 化 需求 说 明 的 成 功 
案例 ， 应 该 是 绰绰有余 的 。 


一 旦 回 退 的 数量 有 所 下 降 ， 并 且 它 们 相对 较 少 出 现 ， 那 么 就 不 必 
再 跟踪 了 。 如 果 遇 到 了 回 退 ， 尝 试 了 解 它 由 何 而 来 。 我 的 一 个 客户 有 
很 多 来 自 他 们 财务 部 门 的 回 退 。 这 表明 他 们 与 公司 财务 部 门 的 沟通 有 
问题 ， 为 此 ， 他 们 寻求 更 好 的 方法 让 那个 部 门 参与 进来 。 

跟踪 回 退 也 是 一 个 很 好 的 方法 ， 可 以 为 引入 实例 化 需求 说 明 提 供 
业务 上 的 支持 。 它 可 以 帮助 团队 查 明 由 需求 模糊 以 及 需求 说 明 里 的 功 
能 分 歧 造 成 的 瀛 费 。 


4.5.3 注意 组 织 级 的 失调 


很 多 团队 在 刚 开始 实施 实例 化 需求 说 明 的 时 候 ， 是 把 它 作为 一 种 
帮助 他 们 在 迭代 中 更 好 地 协调 活动 的 方法 。 而 一 旦 熟悉 了 可 执行 需求 
说 明 ， 并 且 自 动 化 代码 变 得 稳定 之 后 ， 应 该 可 以 在 同一 个 迭代 中 完成 
一 个 故事 ， 并 彻底 做 好 测试 工作 〈 包 括 人 工 的 探索 性 测试 ) 。 如 果 测 
试 人 员 兹 后 于 开发 ， 那 就 做 错 了 。 分 析 没 有 协调 一 致 也 是 一 个 类 似 的 
警告 信号 。 有 些 团队 在 相关 和 迭代 开始 前 就 开始 做 分 析 ， 而 他 们 仍然 拥 
有 规律 性 的 间隔 和 流程 。 事 先 分 析 过 头 、 分 析 不 会 马上 被 实现 的 东 
西 ， 或 者 需要 分 析 细 市 时 却 灌 后 了 ， 这 些 都 是 过 程 出 现 问 题 的 警告 信 


Wo 


4.5.4 当心 “上 = 


在 Lean Software Development — ËF, Maryl Tom PoppendieckS 
道 ， 软 件 开 发 中 最 大 的 浪费 源 是 写 了 很 多 “以 防 万 一 ”的 代码 一 一 实际 
上 不 需要 的 代码 。 我 不 确定 这 是 不 是 最 大 的 浪费 源 ， 但 我 确实 看 到 过 
大 量 的 金钱 、 时 间 和 精力 浪费 在 没 人 需要 的 东西 上 。 实 例 化 需求 说 明 
可 以 显著 减少 这 种 问题 ， 因 为 它 会 帮助 我 们 建立 共识 ， 让 我 们 知道 要 
交付 什么 。Jodie Parker 说 关于 需求 说 明 的 交流 和 协作 帮助 她 的 团队 实 
现 了 这 一 后 : 

“ 当 开发 人 员 拿 到 一 张 故 事 卡 时 ， 他 们 会 非常 希望 交付 其 中 的 一 
切 ， 技 术 上 追求 尽善尽美 ， 即 便 他 们 的 指导 原则 是 ‘做 最 少 的 事情 ， 获 
取 最 大 的 价值 '。 但 效率 要 紧 ， 而 且 我 们 总 能 在 今后 重新 审视 这 些 故 事 


并 加 以 改进 。 对 此 的 一 个 解决 方法 是 ， 通 过 交流 沟通 ， 以 及 持续 不 断 
地 检查 ， 从 我 们 当前 所 做 的 当中 是 否 可 以 看 出 清晰 的 商业 模式 。 通 过 
领域 建 模 ， 你 可 以 很 容易 地 分 解 出 任务 。 那 些 任 务 是 你 唯一 需要 做 
的 。 由 于 任务 都 很 小 ， 你 可 以 按 计划 完成 它们 ， 但 如 果 你 没有 ， 团 队 
的 其 余 成 员 轻 而 易 举 就 会 发 现 ， 他 们 会 坦率 地 说 出 来 。 当 有 人 在 某 个 
任务 上 已 经 工作 了 几 天 ， 那 我 们 会 在 站 立会 议 上 与 他 进行 交流 。” 

有 些 开 发 人 员 实现 的 功能 会 超出 实例 中 的 商定 和 规定 ， 要 注意 这 
些 成 员 。 另 一 个 可 以 避免 “以 防 万 一 ”代码 的 好 方法 是 不 仅 明确 想 要 交 
付 的 范围 ， 同 时 也 讨论 清楚 哪些 不 在 交付 范围 内 。 

4.5.5 3 g 


ANENE MAEAEA (也 叫 作 代 码 异味 ) : 对 一 
个 类 做 很 小 的 改动 后 ， 你 又 需要 对 几 个 相关 的 类 作出 一 系列 改动 。 这 
个 信号 同样 适用 于 活 文档 : 如 果 对 生产 代码 做 了 某 个 改动 后 ， 发 现 还 
需要 修改 很 多 可 执行 需求 说 明 ， 那 说 明 你 有 地 方 做 得 不 对 。 组 织 好 你 
的 活 文档 ， 这 样 对 代码 进行 一 个 小 改动 时 ， 只 需要 对 测试 做 一 个 较 小 
的 更 改 即 可 (请 参考 11.4 节 ， 其 中 有 一 些 好 的 建议 会 教 你 怎么 做 ) o 
这 是 降低 目 动 化 长 期 维护 成 本 的 一 个 天 键 步骤 。 


4.6 铭记 


若 要 为 开发 团队 提供 及 时 的 需求 说 明 ， 实 例 化 需求 说 明 是 一 个 不 
错 的 方法 ， 因 而 它 是 在 短 迭 代 或 基于 流程 的 开发 过 程 里 取得 成 功 的 重 
要 因素 。 

高 效 地 完成 软件 的 一 小 块 ， 确 保 快 速 的 周转 和 快速 的 反馈 。 

强调 有 效 的、 高 效 的 沟通 ， 而 非 隐 长 的 、 之 味 的 文档 。 

整合 跨 功能 的 团队 ,测试 人 员 、 分 析 师 以 及 开发 人 员 为 了 给 系统 
建立 正确 的 需求 说 明 而 一 起 工作 。 

事先 为 自动 化 的 开销 做 好 计划 。 


本 部 分 内 容 

第 5 章 从 目标 中 获取 范围 

第 6 章 通过 协作 制定 需求 说 明 

第 7 章 举例 说 明 

第 8 章 提炼 需求 说 明 

第 9 章 自动 化 验证 而 不 修改 需求 说 明 
第 10 章 频繁 验证 

第 11 章 演化 出 文档 系统 


5 章 示 > 

F-16 战 集 战 斗 机 可 以 说 是 有 史 以 来 最 成 功 的 喷气 式 战斗 机 。 它 的 
成 功 令 人 称奇 ， 因 为 它 成 功 战胜 了 一 切 困 难 。F-16 战 机 设计 于 20 世 纪 
70 年 代 ， 那 时 的 喷气 式 战斗 机 追求 的 是 速度 ， 而 打击 范围 、 武 器 装备 
以 及 机 动 性 在 当时 并 不 怎么 受 重视 中 。 然 而 正 是 F-16 出 色 的 打击 范围 
和 机 动 性 ， 使 它 很 适合 作战 ， 这 确保 了 它 的 成 功 。 


注释 : 请 参考 Kev Darling 的 书 F-16 Fighting Falcon(Combat 
Legend)[F-16 战 集 战 斗 机 (战斗 传奇 ) ](Crowood Press，2005)。 


在 《软件 架构 师 必须 知道 的 97 件 事 》 一 书 中 ，Einar Landre 引 用 了 
F-16 首 席 设计 师 Harry Hillaker 的 话 ， 他 说 飞机 最 初 的 需求 是 飞行 速度 
要 达到 2~2.5 马 赫 。 Hillaker 询 问 美国 空军 这 为 何如 此 重要 ， 得 到 的 答 
复 是 “机 必须 能 从 战斗 中 逃 膨 ”。 尽 管 Hillaker 的 设计 没有 超过 2 马 
赫 ， 但 它 让 飞行 员 可 以 非常 敏捷 地 从 战斗 中 逃脱 。 它 集 很 多 创新 于 一 
身 ， 包 括 无 框 气泡 式 座舱 盖 ， 可 以 获取 更 好 的 视野 ; 倾斜 的 座位 ， 可 
以 降低 重力 对 飞行 员 的 影响 ， 一 个 可 以 在 飞行 员 前 面 投 射 作战 信 息 却 


会 妨碍 视线 的 显示 器 ; 侧 装 式 控 制 杆 ， 能 够 在 高 速 飞行 时 提高 机 动 
性 。 有 了 这 些 功 能 ，F-16 完 胜 其 他 设计 ， 而 且 生产 成 本 更 低 。 它 赢得 
了 设计 比赛 。30 多 年 后 ， 它 仍然 在 生产 。 生 产 数量 超过 4400 架 ， 销 往 
了 25 个 国家 ， 这 个 型 号 取得 了 巨大 的 商业 成 功 。 同 时 ， 它 也 是 最 流 
行 的 战斗 机 之 一 ， 经 常 在 动作 电影 中 出 现 ， 比 如 《X 战 警 2》 和 《变形 
金刚 : 卷土重来 》。 


注释 : @) 请 参考 http:/www.lockheedmartin.comy/products/f16。 


F-16 是 成 功 的 ， 因 为 它 的 设计 比 用 户 要 求 的 解决 方案 更 好 、 更 便 
宜 。 原 先 的 那些 需求 ， 包 括 2.5 马 赫 的 速度 要 求 ， 看 似 问题 的 一 种 解决 
方案 ， 却 并 未 有 效 地 传达 真正 的 需求 。 设 计 师 没 有 直接 去 实现 那些 需 
求 ， 而 是 去 寻求 对 间 题 更 深入 的 理解 。 一 旦 有 了 更 深 的 理解 ， 他 们 束 
可 以 找 出 真正 的 目标 ， 并 从 那些 目标 中 形成 他 们 的 设计 ， 而 不 是 从 建 
议 的 解决 方案 或 有 关 功 能 的 随意 期 望 中 获取 设计 。 这 是 成 功 产品 设计 
的 本 质 ， 在 飞机 研发 中 如 此 ， 在 软件 设计 中 也 同样 重要 。 

与 我 一 起 共事 过 的 两 业 用 户 和 客户 ， 大 多 喜欢 把 需求 描述 成 解决 
方案 ， 他 们 很 少 会 去 讨论 想 要 达到 的 目标 ， 或 者 吸 待 解决 的 问题 具有 
什么 特殊 性 质 。 我 见 过 太 多 的 团队 有 一 种 危险 的 误解 ， 他 们 认为 客户 
总 是 正确 的 ， 客 户 要 求 的 东西 总 是 一 成 不 变 的 。 这 导致 很 多 团队 盲目 
地 接受 客户 建议 的 解决 方案 ， 然 后 竭尽 全 力 去 实现 。 成 功 的 团队 不 会 
那么 做 。 

成 功 的 团队 会 像 F-16 的 设计 师 们 一 样 ， 先 推 开 那些 需求 ， 获 取 更 
多 实际 问题 的 信息 ， 然 后 进行 协作 ， 设 计 出 方案 。 他 们 对 待 范围 也 是 
如 此 ， 范 围 隐 含 着 解决 方案 ， 成 功 的 团队 不 会 把 定义 范围 的 责任 推 到 
其 他 人 身上 ， 他 们 会 积极 协作 ， 同 商业 用 户 一 起 ， 确 定 恨 好 的 范围 ， 
以 期 达到 他 们 的 目标 。 这 就 是 从 目标 中 获取 范围 的 本 质 。 

通过 协作 从 目标 中 获取 范围 无 疑 是 本 书 最 具 争 议 的 话题 。 在 过 去 
的 5 年 中 ， 软 件 开 发 价值 链 的 概念 迅速 普及 ， 提 高 了 大 家 的 认识 ， 那 就 
是 要 协作 确定 软件 的 范围 ， 并 从 商业 目标 中 获取 范围 。 另 一 方面 ， 与 


我 共事 过 的 大 多 数 团队 仍然 认为 项 目 范 围 不 在 他 们 的 掌控 之 中 ， 他 们 
期 望 客户 或 者 商业 用 户 可 以 完全 确定 好 范围 。 在 做 调研 的 时 候 ， 我 发 
现 了 一 种 团队 协作 从 目标 中 获取 项 目 范 围 的 模式 ， 不 过 相 比 其 他 的 天 
键 模式 ， 这 种 实践 不 太 普 遍 。 

本 来 我 想 舍 弃 这 一 章 。 但 我 还 是 决定 把 它 编 进 本 书 ， 原 因 有 以 下 3 
个 。 
在 构建 正确 软件 产品 的 过 程 中 ， 确 定 沁 围 扮 演 着 重要 的 角色 。 汉 
有 正确 的 范围 ， 其 余 的 工作 只 是 在 做 无 用 功 。 

未 来 ， 这 会 成 为 软件 开发 中 最 重要 的 一 个 课题 ， 我 想 提高 大 家 对 
于 这 一 点 的 认识 。 

确定 范围 很 适合 基于 价值 链 的 设计 过 程 ， 价 值 链 的 概念 由 于 精益 
软件 开发 的 普及 而 越 来 越 受 到 欢迎 。 

在 下 面 两 个 小 节 中 ， 我 会 介绍 一 些 确 定 范围 的 方法 ， 无 论 对 那些 
可 以 直接 控制 沁 围 的 团队 ， 还 是 无 法 直接 控制 泥 围 的 团队 ， 这 些 方法 
都 是 有 效 的 。 那 些 对 项 目 沁 围 有 很 高 控制 权 的 团队 ， 可 以 马上 积极 主 
动 地 开始 构建 正确 的 范围 。 遗 憾 的 是 ， 与 我 共事 过 的 几 个 大 型 组 织 
的 许多 团队 都 没有 这 样 的 权利 ， 但 这 并 不 代表 他 们 不 能 影响 项 目 东 
=l 
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用 例 、 用 户 故 事 或 产品 功能 清单 中 的 条 目 提 供 了 项 目 范 围 的 广义 
定义 。 许 多 团队 认为 这 些 工件 是 商业 用 户 、 产 品 负责 人 或 客户 的 责 
任 。 要 求 商 业 用 户 提供 范围 ， 实 际 上 是 依赖 没有 软件 设计 经 验 的 人 来 
提供 高 层次 的 解决 万 案 。 设 计 解 决 方案 是 最 具 挑 战 性 也 是 最 重要 的 步 
又 中 的 一 个 。 引 用 Fred Brooks 在 《人 月 神话 》 一 书 中 的 话 :“ 构 建 软件 
系统 最 难 的 部 分 是 精确 地 定义 构建 的 是 什么 。”Albert Einstein 也 说 过 : 
“问题 的 表述 常常 比 它 的 解决 方案 更 重要 。” 

当前 ， 用 尸 故 事 是 敏捷 和 精益 项 目 中 定义 沁 围 最 流行 的 方式 。 用 
户 故 事 确实 能 很 好 地 提高 人 们 对 软件 项 目 中 商业 价值 的 意识 。 用 户 故 


事 让 我 们 可 以 和 商业 用 户 讨论 他 们 可 以 理解 的 事情 ， 让 他 们 合理 地 安 
排 事 情 的 优先 级 ， 而 不 是 要 求 他 们 在 开发 一 个 集成 平台 和 创建 事务 
CRUD (创建 、 读 取 、 更 新 、 删 除 ) 界面 之 间 做 出 选择 。 需 要 注意 的 
是 每 个 故事 应 该 拥有 一 个 明确 关联 的 商业 价值 。 商 业 用 户 常 常 随 意 地 
选择 价值 的 表达 方式 ( 它 通常 是 冰山 一 角 ) 。 但 是 当 我 们 知道 故事 应 
当 交 付 什么 的 时 候 ， 就 可 以 更 深入 地 调查 研究 并 提出 替代 解决 方案 。 
TechTalk 的 Christian Hassa 解 释 说 : 

“人 们 告诉 你 他 们 自己 认为 需要 什么 ， 通 过 问 他 们 ‘为 什么 '"， 你 可 
以 找到 背后 的 目标 。 许 多 组 织 不 能 明确 地 指出 他 们 的 商业 目标 。 然 
而 ， 一 旦 你 获得 了 目标 ， 就 应 该 再 反 过 来 从 已 确定 的 目标 上 获取 范 
围 ， 可 能 你 会 丢弃 掉 原先 假定 出 来 的 范围 。” 

这 就 是 我 在 Bridging the communication Gap 一 书 中 称 作 挑战 需求 的 
做 法 的 本 质 。 我 仍然 认为 挑战 需求 是 一 项 重要 的 实践 ， 但 是 这 么 做 不 
够 主动 。 虽 然 它 确实 比 被 动 要 好 (我 见 过 的 大 多 数 团队 在 确定 范围 时 
都 是 被 动 的 ) ， 但 还 有 许多 新 兴 的 方法 和 实践 可 以 帮助 团队 更 主动 地 
获得 商业 目标 。 我 们 可 以 一 开始 就 和 商业 用 户 一 起 制定 出 正确 的 故 
事 ， 而 不 是 事后 对 错误 的 故事 作出 反应 。 关 键 在 于 不 要 从 用 户 故 事 开 
始 ， 而 是 从 商业 目标 着 手 并 通过 协作 从 目标 获得 范围 。 
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用 户 故 事 一 般 有 3 个 部 分 :“ 作 为 .……. ， 我 想 要 ...... ET a” 
还 有 一 些 其 他 的 格式 ， 但 都 包含 这 3 个 部 分 。 

~ 要 评估 一 个 建议 的 解决 方案 ， 理 解 为 什么 需要 某 些 东 西 以 及 谁 
需要 它 是 至 关 重要 的 。 

这 些 问题 同样 适用 于 更 高 层次 的 项 目 范 围 。 事 实 上 ， 在 一 个 更 高 
的 层面 上 回答 这 些 问 题 可 以 将 项 目 推 向 完全 不 同 的 方向 。 

来 自 比 利 时 iLean 的 Peter Janssens 曾 经 作为 甲 方 参与 过 一 个 项 目 
一 一 他 是 以 解决 方案 的 形式 提供 需求 的 人 。 他 负责 一 个 存储 本 地 交通 
标志 信息 的 应 用 程序 。 一 开始 对 于 比利时 的 数据 他 们 只 使 用 了 简单 的 
Access 数 据 库 ， 但 是 该 应 用 很 快 就 需要 履 盖 到 世界 上 大 多 数 国家 。 公 


司 在 每 个 国家 都 有 一 个 数据 收集 器 ， 他 们 都 使 用 本 地 Access 数 据 库 ， 
偶尔 需要 将 它们 合并 在 一 起 。 
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为 了 使 工作 更 加 高 效 并 避免 数据 合并 的 问题 ， 他 们 决定 采用 在 线 
数据 库 并 且 使 用 一 个 网 页 应 用 来 维护 它 。 他 们 花 了 4 个 月 联系 供应 商 ， 
比较 报价 ， 最 终 选 定 了 一 家 供应 商 。 这 个 应 用 的 预计 成 本 是 10 万 欧 
元 。 但 是 就 在 他 们 认真 考虑 了 谁 需要 使 用 这 个 应 用 程序 以 及 为 什么 之 
后 ， 项 目 发 生 了 很 大 的 转变 。Janssens 说 : 

“在 决定 是 否 做 这 个 项 目的 前 一 天 ， 开 发 部 门 的 一 个 家 伙 为 了 更 好 
地 理解 ， 再 次 询问 了 我 当前 面临 的 问题 。 我 说 :我们 需要 一 个 中 心 数 
据 库 的 网 页 解决 方案 。” 他 说 : ‘不 ， 不 ， 我 们 不 要 直接 跳 到 结论 。 不 
要 马上 描述 你 需要 哪个 解决 方案 ， 请 先 解 释 一 下 。; 我 又 解释 了 一 遍 。 
然后 他 说 : 那么， 你 的 问题 实际 上 是 需要 在 一 个 单独 的 数据 源 上 工 
作 ， 因 为 你 不 想 浪 费时 间 做 合并 。;”‘ 是 的 ，’ 我 说 ，‘ 正 确 。， 

他 提 了 第 二 个 问题 :“ 谁 会 使 用 它 ? Rit: “ 瞧 ， 此 时 此 刻 我 们 有 
10 个 国家 的 数据 ， 所 以 有 10 个 人 。 :我 们 看 了 看 数据 库 ， 意 识 到 这 类 交 
通信 息 不 会 经 常 改变 ， 可 能 每 个 国家 一 年 就 改变 一 两 次 。 然 后 他 
W: ‘Peter， 听 着 ， 你 的 问题 明天 就 可 以 解决 。’ 第 二 天 他 在 他 们 的 
Citrix (远程 桌面 ) 服务 器 上 添加 了 数据 库 。” 


应 用 程序 总 共 需 要 支持 10 个 用 户 ， 他 们 只 在 更 新 交通 标志 信息 时 
使 用 它 ， 而 这 种 改动 很 少 发 生 。Access 应 用 程序 足以 应 付 这 个 数据 
量 ， 他 们 真正 的 问题 只 有 合并 。 一 旦 技术 工程 师 理解 了 潜在 问题 ， 他 
可 以 提供 比 原 来 建议 的 解决 方案 要 便宜 得 多 的 方案 。Janssens 解 释 说 : 

“我 了 解 到 这 是 一 个 真正 的 对 峙 局 面 一 一 理解 导致 需求 的 核心 问题 
总 是 很 重要 。 所 以 理解 “为 什么 :很 重要 。 最 后 ， 当 我 们 谈 到 “ 谁 ' 的 问题 
时 ， 他 想到 了 Citrix 解 决 方案 。 通 常 一 个 月 只 有 一 个 用 户 使 用 它 。>” 

就 算是 在 沁 围 的 层面 上 ， 也 可 能 隐 合 了 解决 方案 。 还 未 人 确定 可 能 
的 用 户 故 事 或 用 例 ， 也 没有 为 了 划分 任务 而 讨论 需求 说 明 ， 束 有 人 建 
议 使 用 网 页 应 用 程序 ， 这 个 事实 就 隐 含 了 一 个 解决 方案 。 他 们 使 用 一 
个 零 成 本 的 快速 修复 方案 就 解决 了 问题 ， 而 不 是 花 5 个 月 选择 供应 商 ， 
并 伦 更 长 的 时 间 来 交付 项 目 。 理 解 为 什么 有 人 需要 某 个 特定 的 应 用 程 
序 以 及 他 们 将 如 何 使 用 ， 往 往 能 得 到 更 好 的 解决 方案 。 这 是 一 个 极端 
的 例子 ， 但 它 证 明了 这 一 点 。 


理解 价值 从 何 而 来 ， 除 了 可 以 帮助 我 们 设计 出 更 好 的 解决 方案 以 
外 ， 还 可 以 极 大 地 帮助 我 们 排列 优先 级 。 在 一 家 美国 大 型 保险 公司 ， 
rob Park 的 团队 只 在 较 高 层次 的 功能 级 别 上 排列 优先 级 ， 他 们 不 用 在 较 
低层 次 的 故事 级 别 上 做 同样 的 事 ， 这 可 以 节省 很 多 时 间 。Park 说 : 

“我 们 以 高 层次 的 角度 来 描述 商业 价值 和 功能 的 核心 。 我 们 把 功能 
分 解 成 尽 可 能 小 的 故事 。 举 个 例子 来 说 : 为 14 个 州 以 PDF 格式 提供 保 
险 证 明 。 尤 其 从 商业 角度 来 说 ， 我 尝试 推行 :这 有 多 大 的 价值 ， 用 美元 
来 衡量 ;的 方法 。 在 这 个 例子 中 ， 我 们 有 一 个 资深 成 员 说 : ‘50% 的 电 
话 来 访 是 这 个 目的 ， 其 中 50% 的 来 访 是 为 保险 卡 的 证 明 而 来 的 ， 所 以 
只 有 25% 的 来 访 是 这 个 目的 。 他 们 知道 每 天 有 多 少 电话 来 访 ， 他 们 也 
了 解 自动 生成 PDF 相 比 以 前 人 工 复制 粘贴 能 节约 多 少时 间 ， 所 以 事实 
上 他 们 可 以 给 出 具体 的 数据 ， 这 是 非常 棒 的 。” 

=> 比 起 只 在 故事 层次 上 进行 讨论 ， 在 目标 层次 上 进行 讨论 能 使 团 
队 更 加 高 效 地 处 理 范围 和 优先 级 。 


一 个 可 以 从 中 受益 的 方面 就 是 估算 工作 量 。rob Park 的 团队 发 现 ， 
讨论 目标 使 他 们 不 必 浪 费时 间 在 单个 故事 的 估算 上 : 

“我 们 真 的 不 想 在 估算 故事 上 人 花费 太 多 心思 。 如 果 你 开始 估算 故 
事 ， 使 用 斐 波 那 契 数列 ， 你 很 快 就 会 意识 到 ， 对 于 一 个 迭代 来 说 要 交 
付 任何 大 于 或 等 于 8 个 点 的 故事 ， 它 都 太 大 了 ， 所 以 我 们 只 用 1、2、3 
和 5。 之 后 到 了 一 个 新 的 水 平 ， 你 就 会 说 5 个 点 也 很 大 。 现 在 全 部 都 是 
1、2 和 3， 它 们 其 实 都 差不多 的 。 我 们 可 以 把 较 高 层次 的 故事 分 解 成 大 
小 都 差不多 的 故事 ， 不 用 去 估算 它们 ， 只 需要 衡量 一 下 需要 多 少时 
间 ， 看 什么 时 候 可 以 交付 就 行 了 。” 

在 Software by Numbers 一 书 中 ，Mark Denne 和 Jane Cleland-Huang 
讲述 了 一 个 正式 的 排列 优先 级 的 方法 ， 由 商业 价值 驱动 ， 把 沁 围 分 解 
成 最 小 可 销售 的 功能 。 以 我 的 经 验 来 看 ， 预 测 某 个 东西 能 赚 多 少 钱 和 
预测 实现 这 个 功能 需要 多 长 时 间 一 样 困 难 ， 并 且 很 可 能 不 准 。 但 如 果 
你 的 领域 使 你 可 以 给 这 些 功 能 标 上 数值 ， 这 将 帮助 你 让 商业 用 户 参 与 
进来 。 让 他 们 来 排列 功能 甚至 是 商业 目标 的 优先 级 ， 比 让 他 们 给 具体 
的 故事 或 任务 排列 优先 级 要 容易 得 多 。 


当 很 难 确定 目标 的 时 候 ， 预 期 系统 的 输出 是 比较 有 用 的 出 发 点 : 
研究 为 什么 需要 这 些 输 出 以 及 软件 如 何 提供 这 些 结 果 。 一 旦 你 明确 了 
期 望 的 输出 ， 就 可 以 专注 于 实现 这 些 输 出 背后 的 需求 。 分 析 为 什么 需 
要 这 些 输出 结果 可 以 帮助 你 构想 出 项 目的 目标 。 

-我 们 应 该 从 输出 结果 的 实例 开始 着 手 ， 而 不 要 和 商业 用 户 一 起 
讨论 如 何 往 系 统 里 增加 某 些 东西 。 这 将 帮助 商业 用 户 加 入 到 讨论 中 
来 ， 并 让 他 们 对 系统 的 输出 有 一 个 清晰 的 认识 。 

Wes Williams 曾 经 在 Sabre 参 与 过 一 个 项 目 ， 当 时 由 于 用 户 界面 开 
发 的 延迟 导致 了 很 多 返工 : 

“在 客户 看 到 图 形 界面 之 前 ， 领 域 (应 用 层 ) 的 验收 测试 就 已 经 编 
写 好 了 。 界 面 推 迟 了 大 概 4 个 月 。 客 户 看 到 的 界面 ， 与 他 们 想象 的 完全 
不 一 样 。 而 当 我 们 开始 为 UI 编写 测试 时 ， 客 户 所 要 求 的 测试 数量 远 远 


比 领域 (E) 的 多 。 因 此 领域 代码 必须 做 出 修改 ， 但 客户 却 认为 那 部 
分 工作 已 经 完成 了 。 他 们 认为 测试 已 经 有 了 ， 而 且 运 行 也 通过 了 ， 所 
以 该 部 分 工作 就 算 完成 了 。>” 

对 系统 预期 的 输出 结果 可 以 帮助 我 们 发 现 目标 ， 并 可 以 帮 有 我 们 确 
定 到 底 需 要 构建 什么 内 容 来 提供 支持 。 甚 至 在 未 做 敏捷 项 目 之 前 ， 
Adam Geras 就 已 经 通过 这 个 思想 关注 于 构建 正确 的 东西 : 

“我 们 在 很 多 项 目 中 使 用 了 一 种 称 为 报表 优先 ' 的 方法 ， 但 它 只 适 
用 于 史诗 故事 的 级 别 ， 而 且 我 们 主要 是 在 ERP 实 施 里 使 用 这 种 方法 ， 
不 是 敏捷 项 目 。 这 种 方法 非常 适 舍 我 们 ， 因 为 找 出 报表 中 某 项 缺失 的 
数据 元 素 要 经 过 大 量 返 工 。 我 们 通过 优先 考虑 输出 结果 来 避免 此 类 返 
Eo Ra 

从 系统 的 输出 来 获取 范围 的 想法 出 自 于 BDD 社 区 。 这 个 想法 最 近 
受到 很 多 关注 ， 因 为 它 解 决 了 一 个 普遍 存在 的 问题 。 在 我 早期 的 许多 
项 目 中 ， 我 们 着 重 关注 处 理 流程 ， 并 且 一 开始 就 把 数据 放 入 到 系统 
中 。 我 们 将 处 理 过 程 的 最 终结 果 (如 报表 ) 放 在 了 最 后 。 这 种 方式 的 
问题 是 商业 用 户 要 到 能 看 到 可 视 化 输出 结果 的 时 候 才 参与 进来 ， 这 样 
常常 导致 返工 。 从 输出 部 分 开始 工作 ， 能 确保 商业 用 户 可 以 一 直 提 供 


反馈。 


适用 于 : 商业 用 户 信任 开发 团队 的 时 候 

uSwitch 的 团队 与 他 们 的 商业 用 户 一 起 定义 用 尸 故事 。 商 业 用 户 给 
出 故事 中 的 利益 相关 者 和 期 望 的 价值 ， 开 发 团队 给 出 隐 含 解决 方案 的 
部 分 。 在 标准 的 用 户 故事 格式 中 ， 这 意味 着 商业 用 户 提 供 “ 作 为 …...” 
和 “为 了 .……” 语 句 ， 开 发 人 员 提 供 “我 想 要 .……” 语 句 。 


用 户 故 事 
| 商业 用 户 | 开发 人 员 
mlx 


目的 是 


~ 目标 中 获取 正确 范围 的 一 个 好 方法 ， 就 是 坚定 不 移 地 把 提供 解 
决 方案 的 责任 交付 给 开发 团队 。 

如 果 你 有 季 可 以 在 高 层次 的 级 别 上 控制 项 目的 范围 ， 请 确保 开发 
人 员 和 测试 人 员 都 参与 到 讨论 中 ， 并 使 解决 方案 着 重 关 注 实现 已 明确 
定义 的 商业 目标 。 这 将 消除 今后 大 量 不 必要 的 工作 ， 同 时 为 协作 制定 
需求 说 明 做 好 准备 。 

用 户 故 事 的 组 成 部 分 

用 户 故 事 描述 了 用 户 如 何 从 系统 中 获得 特定 的 价值 。 团 队 一 般 使 
用 用 户 故 事 来 做 计划 并 对 短期 工作 的 范围 进行 优先 级 排列 。 用 户 故 事 
通常 由 以 下 3 部 分 组 成 : 

作为 利益 相关 者 ; 

为 了 实现 某 件 有 价值 的 事情 ; 


我 想 要 某 个 系统 功能 。 

举例 来 说 , “作为 市 场 经 理 ， 为 了 能 够 直接 向 客户 推销 产品 ， 我 想 
要 系统 在 客户 注册 忠诚 度 计 划 时 记录 客户 的 个 人 信息 。” 

不 同 的 作者 会 把 这 3 部 分 按 不 同 的 顺序 排列 ， 但 是 这 3 部 分 都 是 需 
要 记录 的 。 本 书 为 了 不 同 的 目的 会 对 用 户 故 事 的 这 些 部 分 采用 各 种 不 
同 的 顺序 。 


对 大 多 与 我 共事 过 的 团队 ， 尤 其 是 那些 大 公司 的 团队 来 说 ,项目 
范围 是 从 上 级 部 门 传递 给 他 们 的 一 种 东西 。 许 多 团队 认为 ， 当 他 们 只 
维护 大 型 系统 的 一 小 部 分 时 ， 讨 论 商业 目标 是 不 可 能 的 事情 。 然 而 即 
使 是 这 种 情况 ， 了 解 商 业 用 户 试图 实现 的 目标 也 可 以 帮助 你 使 项 目 专 
注 于 真正 重要 的 事情 。 

以 下 是 一 些 提示 ， 它 们 将 有 助 于 在 没有 项 目 高 层次 控制 权 的 时 候 
局 效 地 进行 协作 确定 项 目 沁 围 。 

5.2.1 询问 “为 什么 这 些 te 
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Stuart pelea ia car aur cin 
这 个 例子 就 是 
salem ee G 即使 是 在 这 种 情况 下 ， 他 们 还 是 成 
功 战胜 了 被 分 配 任务 的 命运 ， 并 获得 了 真正 的 需求 。 

Ervine 团 队 的 任务 是 提高 树 状 层次 的 性 能 ， 这 听 起 来 像 是 一 
正 的 业务 需求 ， 具 有 了 明显 的 效益 a 
问题 ， 因 此 任何 重大 的 改善 都 需要 修改 底层 的 东西 。 

他 们 向 用 户 询问 如 何 提 高 性 能 才 会 有 帮助 。 结 果 发 现 用 户 要 上 自己 
遍历 层次 结构 ， 增 加 账户 余额 ， 以 此 来 手工 执行 复杂 的 计算 。 由 于 交 
易 对 方 数量 很 多 ， 他 们 必须 不 断 地 在 用 户 界 面 上 展开 折 区 树枝， 并 增 
加 账户 余额 一 一 这 是 一 个 缓慢 而 且 容 易 出 错 的 计算 过 程 。 
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他 们 没有 去 提高 树 状 层 次 的 性 能 ， 而 是 为 用 户 自 动 化 了 整个 计算 
过 程 。 这 让 计算 过 程 几乎 变 成 了 即时 计算 ， 而 且 显 著 减少 了 出 错 的 可 
能 性 。 这 个 解决 方案 带 来 了 更 好 的 结果 ， 并 且 成 本 也 比 原先 所 需 的 解 
决 方案 更 低廉 。 

-我 们 应 该 间 询 高 层次 的 实例 ， 说 明 某 个 功能 如 何 产 生 实际 价 
值 ， 而 不 是 去 问 询 技术 上 的 功能 需求 说 明 。 这 将 指引 我 们 找到 真正 的 
问题 。 

在 Bridging the Communication Gap 一 书 中 ， 我 建议 询问 “为 什么 ”， 
并 不 断 重 复 这 个 问题 ， 直 到 答案 开始 提 及 金钱 。 现 在 我 认为 ,为 了 得 
到 相同 的 结果 ， 一 个 更 好 的 方法 是 要 求 提供 实例 来 解释 某 个 功能 如 何 
市 来 帮助 。 提 出 “为 什么 需要 这 些 东 西 * 这 样 的 问题 ， 听 起 来 有 点 质疑 
的 口气 ， 这 会 让 他 人 产生 防御 心态 ， 特 别 是 在 大 型 组 织 里 更 是 如 此 。 
有 反之， 询问 “为 什么 这 些 东 西 有 用 ”， 这 种 方式 以 讨论 的 口吻 开始 ， 便 
不 会 挑战 任何 人 的 权威 性 。 

5.2.2 询问 蔡 代 方案 

除了 询问 某 些 东西 如 何 带 来 帮助 以 便 获 得 真正 的 商业 目标 ， 
Christian Hassa 的 建议 是 讨论 蔡 代 方案 。Hassa 解 释 道 : 

“有 时 候 ， 大 家 解释 某 个 功能 的 价值 时 ， 仍 然 会 有 困难 (即便 是 要 
求 提供 实例 时 ) 。 更 进一步 ， 我 会 让 他 们 举 出 一 个 例子 ， 说 明 如 果 系 
统 不 提供 某 个 功能 ， 他 们 会 怎么 做 (临时 解决 方案 ) 。 通 常 这 会 帮助 
他 们 表达 出 特定 功能 的 价值 。” 

-从 商业 角度 发 现 其 他 选择 ， 一 个 好 的 策略 是 寻求 替代 方案 。 

寻求 替代 方案 可 以 让 功能 的 提出 者 再 次 进行 思考 ， 所 提议 的 解决 
方案 是 否 是 最 佳 方 案 。 同 时 ， 也 应 该 与 交付 团队 一 起 讨论 替代 方案 。 


By 


5.2.3 只 顾 最 低层 
由 于 要 让 交付 内 容 瘦身 以 便 适 合 一 个 迭代 ， 许 多 团队 会 将 产品 功 
能 清单 分 割 成 更 低层 次 的 东西 。 昌 然 这 样 有 助 于 简化 工作 流程 ， 但 也 
可 能 让 团队 忽略 了 大 局 。 


= 作为 一 个 过 程 ， 实 例 化 需求 说 明 对 于 高 层次 的 故事 和 低层 次 的 
故事 都 是 有 用 的 。 一 旦 我 们 获取 到 高 层次 的 例子 ， 可 以 说 明 某 个 功能 
如 何 产生 作用 ， 我 们 就 可 以 将 其 捕获 成 高 层次 的 需求 说 明 。 这 种 高 层 
次 的 例子 让 我 们 可 以 客观 地 权衡 是 否 交付 某 个 功能 。 

Ismo Aro 参 与 过 诡 基 亚 西门 子 的 一 个 项 目 ， 因 为 他 们 没有 高 层次 
的 需求 说 明 ， 他 的 团队 受到 了 挫折 。 他 说 : 

“用 户 故 事 必 须 适 舍 sprint。 当 一 系列 的 此 类 故事 完成 时 ， 就 对 它 
们 进行 独立 测试 。 更 大 的 用 户 故 事实 际 上 没有 进行 测试 。 当 用 户 故 事 
的 粒度 较 小 的 时 候 ， 你 无 法 从 产品 功能 清单 上 判断 某 项 功能 是 否 真 的 
完成 了 。” 

将 较 大 的 用 户 故 事 分 割 成 较 小 的 可 以 单独 交付 的 故事 是 一 种 很 好 
的 实践 。 为 了 了 解 故事 何 时 完成 ， 我 们 仍然 需要 查看 较 高 层次 的 故 
事 。 为 了 兼顾 高 层次 的 故事 和 低层 次 的 故事 ， 我 们 需要 一 个 分 层 的 功 
能 清单 ， 而 不 是 扁平 的 、 线 型 的 功能 清单 。 

较 低层 次 的 需求 说 明和 测试 可 以 告诉 我 们 已 经 交付 部 分 的 逻辑 是 
否 正确 ; 而 较 高 层次 的 验收 测试 则 可 以 告诉 我 们 那些 部 件 是 否 按 预期 
方式 工作 。 
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5.2.4 Ss 


适用 于 : 大 型 多 站 点 项 目 

Wes Williams 把 5.1.3 节 中 所 描述 的 问题 归咎 于 团队 的 分 工 。 不 同 
的 团队 交付 系统 的 不 同 组 件 (这 里 指 的 是 领域 层 和 用 户 界面 ) ， 这 让 
划分 工作 变 得 很 困难 ， 难 以 让 每 个 团队 与 他 们 的 用 户 一 起 讨论 期 望 的 
输出 。 因 此 他 们 重组 了 团队 的 工作 ， 让 他 们 可 以 交付 完整 的 功能 。 
Williams 评 论 道 : 

“我 们 用 了 半年 左右 的 时 间 组 建 起 了 功能 团队 。 这 带 来 了 非常 不 同 
的 结果 ， 尤 其 是 在 某 种 意义 上 说 ， 它 消除 了 一 些 相同 的 工作 、 大 量 的 
重复 劳动 以 及 很 多 返工 。 幸 运 的 是 ， 我 们 已 经 有 很 多 测试 可 以 协助 我 
们 这 么 做 。 我 们 有 时 必须 回 过 头 去 加 入 一 些 新 的 功能 ， 但 那 大 多 是 增 
加 一 一 而 不 是 修改 。>” 


— 当 团 队 交 付 完 整 的 功能 时 ， 他 们 可 以 更 加 密切 地 与 商业 用 户 一 
起 设计 范围 并 确定 需要 构建 的 内 容 ， 这 只 是 因为 他 们 可 以 与 用 户 讨 论 
完整 的 功能 。 更 多 有 关 功 能 团队 的 信息 ， 请 参考 电子 书 Feature Team 
Primer 功能 团队 入 门 ?。 


注释 : Ohttp://www.featureteams.org 


即使 没有 项 目 范 围 的 高 层次 控制 权 ， 团 队 仍然 可 以 通过 以 下 方法 
影响 项 目 构建 的 功能 : 

对 需求 积极 提出 质疑 ; 

了 解 真正 的 商业 目标 ; 

了 解 堆 需要 以 及 为 什么 需要 何 种 功能 。 

虽然 结果 不 如 一 开始 就 从 商业 目标 中 获得 正确 的 范围 来 得 有 效 ， 
但 这 种 万 法 可 以 避免 在 后 来 的 过 程 中 进行 不 必要 的 返工 ， 同 时 可 以 确 
保 商业 用 户 得 到 他 们 所 需 的 软件 。 


D.3 = 


目前 在 这 个 领域 有 众多 创新 ， 而 本 书 涉及 的 只 是 我 采访 的 团队 所 
使 用 的 一 些 方 法 。 

相关 的 新 兴 技 术 也 值得 一 提 ， 可 以 写成 另 一 本 书 。 要 了 解 如 何 从 
目标 中 获取 范围 的 前 沿 技术 ， 以 及 如 何 勾画 它们 之 间 的 关系 ， 请 参考 


以 下 内 容 : 
特性 注入 : 一 种 通过 高 层次 的 实例 ， 迫 代 式 地 从 目标 中 获取 范围 
的 方法 ; 


效应 映射 : 一 种 针对 项 目 范 围 的 可 视 化 技术 ， 层 次 化 分 析 目 标 、 
利益 相关 者 以 及 功能 ; 

用 户 故 事 映 射 : 一 种 提供 全 局 概览 的 用 户 故 事 层次 化 映射 技术 。 

遗憾 的 是 ， 关 于 以 上 新 兴 实 践 的 出 版 物 非常 少 。 据 我 所 知 ， 唯 一 
提 及 特性 注入 的 出 版 物 是 一 本 漫画 2 ， 次 优 的 材料 是 来 自 Chris Matts 
的 有 关 Picasa 的 笔记 的 一 些 扫描 件 S。 唯 一 涉及 效应 映射 的 出 版 物 是 
一 本 用 瑞典 语 写 的 书 ， 英 文 译本 为 Effect Managing IT? ， 其 翻译 质量 
RÆ; 此 外 我 在 网 上 也 发 布 了 一 本 相关 的 白皮书 号 Jeff Patton 的 博客 
提供 了 很 多 关于 被 动 和 主动 获取 范围 的 内 容 @ ， 相 当 不 错 ， 同 时 他 正 
在 编写 一 本 关于 敏捷 产品 设计 的 书 ， 和 希望 能 更 多 地 涉及 该 领域 。 


注释 : @Ellwww.lulu.com/product/file-download/real-options-at- 
agile-2009/5949486 可 免费 下 载 。 


注释 : @http://picasaweb.google.co.uk/chris.matts/FeatureInjection# 


注释 : @Mijo Balic 和 Ingrid Ottersten 的 Effect Managing 
IT(copenhagen Business Schooll Press，2007)。 


注释 : Ohttp://gojko.net/effect-map 
注释 : ©www.agileproductdesign.com 
5.4 铭记 


当 需 求 作为 任务 分 配给 你 时 ， 先 停 一 停 : 请 获得 必要 的 信息 ， 以 
便 理解 真正 的 问题 ， 然 后 进行 协作 设计 解决 方案 。 

如 果 无 法 避免 任务 式 需求 ， 请 先 想 办 法 获取 到 高 层次 的 实例 ， 解 
析 需 求 如 何 起 作用 。 如 此 将 有 助 于 理解 谁 以 及 为 什么 需要 这 些 需 求 ， 
这 样 你 才能 设计 解决 方案 。 

为 了 获取 适当 的 沁 围 ， 请 考虑 一 下 当前 这 个 里 程 碑 的 商业 目标 ， 
想 一 想 哪 些 项 目 干 系 人 可 以 出 一 份 力 ， 又 有 了 哪些 项 目 干系 人 会 受到 这 
个 里 程 碑 影响 。 

以 系统 的 输出 为 出 发 点 ， 可 以 让 商业 用 户 更 多 地 参与 进来 。 

把 组 件 团 队 改组 为 能 够 交付 完整 功能 的 团队 。 

调查 新 兴 技 术 ， 包 含 特性 注入 、 用 户 故事 映射 以 及 效应 映射 ， 以 
便 有 效 地 从 目标 中 获取 范围 。 


实例 化 需求 说 明 在 概念 上 与 传统 的 需求 说 明 或 测试 过 程 是 不 一 样 
的 ， 特 别 是 它 基 于 协作 的 方式 。 如 果 我 们 独自 编写 文档 而 不 寻求 协 


作 ， 那 么 即使 采用 了 本 书 介绍 的 其 余 所 有 模式 ， 实 例 化 需求 说 明 也 无 
法 发 挥 作用 。 

在 Bridging the communication Gap 一 书 中 ， 我 专注 于 将 大 型 的 、 
队 全 体 参 与 的 需求 说 明 工 作坊 作为 协作 式 需 求 说 明 的 主要 工具 。 而 在 
编写 这 本 书 的 过 程 中 ， 我 最 大 的 一 个 感触 是 现实 的 情况 要 比 前 一 本 书 
介绍 的 复杂 得 多 。 针 对 协作 式 需 求 说 明 ， 不 同 的 团队 在 不 同 的 环境 中 
都 会 有 他 们 各 自 的 方式 ， 即 使 来 自 同一 组 织 的 团队 ， 其 协作 方式 也 不 
尽 相 同 。 

在 本 章 中 ， 我 将 介绍 协作 式 需 求 说 明 最 常见 的 模型 ， 包 括 大 型 工 
作坊 、 小 型 工作 坊 以 及 最 流行 的 工作 坊 替 代 方 式 。 这 将 帮助 你 理解 各 
种 协作 式 需 求 说 明 方法 的 优 缺 点 。 我 还 会 介绍 一 些 很 好 的 实践 方法 ， 
用 于 准备 协作 ， 同 时 还 有 一 些 很 好 的 想法 ， 可 以 帮助 你 为 团队 选择 合 
适 的 协作 模型 但 是 我 们 首先 要 面 对 的 问题 是 到 底 有 没有 必要 进行 协 
{Fo 

为 了 更 好 地 介绍 一 个 协作 式 需 求 说 明 的 例子 ， 我 们 还 需要 回顾 一 
个 与 此 相关 的 做 法 : 举例 说 明 。 你 将 在 本 书 7.1 节 中 看 到 如 何 举办 一 个 
需求 说 明 工 作坊 的 例子 。 


6.1 2 | 


协作 制定 需求 说 明 是 一 个 非常 好 的 方法 ， 可 以 对 我 们 需要 完成 的 
内 容 建立 共识 ， 并 确保 系统 的 各 个 方面 都 被 包含 在 需求 说 明 中 。 协 作 
还 有 助 于 团队 制定 易于 理解 的 需求 说 明和 容易 维护 的 测试 。 

Jodie Parker 认 为 ， 他 们 在 LMAX 实 施 实 例 化 需求 说 明 的 一 个 最 大 
问题 是 在 制定 需求 说 明 时 没有 进行 协作 。 她 说 : 

“大 家 没有 意识 到 交谈 是 多 么 富有 价值 。 开 发 人 员 起 初 认 为 测试 人 
员 对 交谈 不 感 兴趣 ， 因 为 开发 人 员 太 过 技术 性 ， 而 测试 人 员 可 以 了 解 
如 何 和 代码 库 打 交道 、 他 们 可 以 提出 建议 告诉 你 有 什么 地 方 可 能 会 对 
其 他 测试 有 所 影响 ， 或 者 需要 对 语言 做 出 什么 修改 。 测 试 人 员 也 认为 
他 们 太 忙 了 。 你 只 有 通过 实践 才能 知道 协作 式 需 求 说 明 多 有 价值 。” 


即使 对 软件 系统 所 涉及 的 业务 领域 有 非常 完善 的 理解 (我 从 来 没 
有 见 过 这 样 的 团队 ) ， 协 作 制 定 需求 说 明 依 然 是 值得 的 。 分 析 人 员 和 
测试 人 员 可 能 知道 需要 说 明和 测 试 什么 ， 但 是 不 一 定 知 道 如 何 组 织 这 
些 信 息 才 能 容易 地 进行 自动 化 并 驱动 开发 一 一 程序 员 却 知道 。Marta 
Gonzalez Ferrero 曾 参与 过 一 个 项 目 ， 起 初 测 试 人 员 自 己 编写 了 所 有 的 
验收 测试 ， 他 们 并 不 认为 那些 是 需求 说 明 。 她 说 开发 人 员 经 常 不 知道 
如 何 使 用 这 些 测试 : 

“在 最 开始 ， 测 试 人 员 制 作 FitNesse 表 格 并 交 给 开发 人 员 。 这 么 做 
导致 了 一 些 问题 ， 因 为 开发 人 员 返 回来 说 这 些 页 面 很 难 理解 或 者 很 难 
自动 化 。 之 后 ， 他 们 开始 一 起 工作 。>” 

协作 制定 需求 说 明和 编写 验收 测试 的 工作 没有 做 好 ， 最 终 必然 会 
导致 测试 的 维护 成 本 过 高 。 这 是 LisaCrispin 从 测试 设计 中 得 到 的 一 个 
最 重要 的 教训 。 她 解释 说 : 

“无 论 何 时 ， 当 我 们 必须 做 出 更 改 的 时 候 ， 我 们 都 有 太 多 的 测试 
(可 执行 的 需求 说 明 ) 需要 修改 。 如 果 有 很 多 测试 ， 就 很 难 重 构 。 我 
应 该 和 开发 人 员 一 起 结对 ， 让 他 们 帮助 我 设计 测试 。 我 可 以 很 容易 地 
表述 出 问题 ; 我 能 看 出 有 什么 问题 。 测 试 人 员 知 道 一 些 基本 概念 ， 比 
如 ‘不 要 重复 自己 (DRY)， 但 是 他 们 对 工具 没有 良好 的 理解 。” 

因为 Crispin 在 编写 并 自动 化 可 执行 的 需求 说 明 时 ， 疫 有 同 开发 人 
员 进 行 协作 ， 她 编写 了 太 多 不 容易 长 期 维护 的 需求 说 明 。 

我 采访 的 许多 团队 在 早期 都 犯 了 类 似 的 错误 。 当 开发 人 员 独 目 编 
写 需 求 说 明 时 ， 这 些 文 档 最 终 和 软件 设计 绑 定 得 太 过 紧密 ， 不 容易 理 
解 。 如 果 测 试 人 员 独 上 自 编 瑟 需 求 说 明 ， 这 些 文档 又 会 组 织 得 不 好 ， 难 
以 维护 。 相 比 之 下 ， 成 功 的 团队 碰 到 此 类 问题 后 会 很 快 转换 到 更 注重 
协作 工作 模式 上 去 。 


6.2 最 热 | y 


虽然 我 采访 的 所 有 团队 都 通过 协作 制定 需求 说 明 ， 但 是 他 们 协作 
的 方式 却 是 五 花 八 门 ， 从 大 型 的 全 体 工 作坊 到 小 型 工作 坊 ， 甚 至 于 随 


意 的 交谈 。 下 面 是 一 些 最 常见 的 协作 模型 以 及 团队 从 中 获得 的 好 处 。 
6.2.1 党 型 T 


适用 于 : 从 一 开始 就 使 用 实例 化 需求 说 明 时 

需求 说 明 工作 坊 是 对 领域 和 范围 进行 密集 的 、 杀 自动 手 的 探索 实 
践 ， 它 确保 实施 团队 、 商 业 利 益 相 关 者 和 领域 专家 对 系统 功能 建立 一 
致 的 共识 。 我 在 Bridging the Communication Gap 中 对 此 有 详细 的 描 
述 。 工 作坊 确保 开发 人 员 和 测试 人 员 有 足够 的 信息 来 完成 他 们 当前 迭 
代 的 工作 。 

-团队 全 体 参 加 的 大 型 需求 说 明 工 作坊 是 建立 共识 并 获取 实例 最 
有 效 的 途径 之 一 ， 那 些 实 例 对 功能 进行 了 详细 的 描述 。 

在 工作 坊 中 ， 程 序 员 和 测试 人 员 可 以 了 解 业 务 领域 。 商 业 用 户 开 
始 理解 系统 的 技术 约束 。 由 于 团队 全 体 的 参与 ， 工 作坊 可 以 有 效 地 利 
用 商业 利益 相关 者 的 时 间 ， 并 且 以 后 不 再 需要 做 知识 传递 。 

uSwitch 的 团队 一 开始 使 用 需求 说 明 工 作坊 来 帮助 实施 实例 化 需求 
说 明 。Jon Neale 这 样 描 述 其 效果 : 

“ 它 对 商业 人 员 梳 理 不 大 清晰 的 思路 特别 有 帮助 。 例 如 ， 如 果 有 人 
尝试 申请 低 于 一 定金 额 的 贷款 ， 相 比 一 般 的 贷款 申请 而 言 ， 这 完全 是 
另 一 个 场景 。 直 到 最 后 一 分 钟 仍然 有 大 量 的 业务 规则 没有 涉及 。 

需求 说 明 工 作坊 帮助 了 他 们 事先 考虑 这 些 场 景 ， 也 帮助 我 们 做 得 
更 快 。 它 还 有 助 于 开发 团队 更 容易 地 与 其 他 人 进行 交流 。 这 样 的 前 题 
讨论 使 得 整个 过 程 更 加 顺利 一 一 其 立竿见影 的 效果 就 是 有 了 更 多 的 沟 
通 。>” 

在 PBR 工 作坊 中 实施 需求 说 明 工 作坊 

产品 功能 清单 精炼 工作 坊 (Product Backlog Refinement，PBR) 是 
实施 好 Scrum 过 程 的 一 个 关键 元 素 。 同 时 ， 我 发 现 大 多 数 声称 在 运用 
Scrum 的 团队 实际 上 并 没有 PBR 工 作坊 。PBR 工 作坊 一 般 由 团队 全 体 
参加 ， 它 的 主要 工作 包括 对 功能 清单 上 优先 级 最 高 的 项 目 进行 分 解 ， 
并 对 其 进行 详细 分 析 以 及 重新 估算 。 在 Practices for Scaling Lean and 


Agile 一 书 中 ，Bas Vodde 和 Craig Larman 建 议 PBR 工 作坊 应 该 占据 
每 个 迭代 5%~10% 的 时 间 。 


注释 : (DCraig Larman 和 Bas Vodde, Practices for Scaling Lean & 
Agile Development Large, Multisite, and Offshore Product Development 
with Large-Scale Scrum(Pearson Education, 2010). 


在 成 熟 的 Scrum 团 队 中 开始 实施 实例 化 需求 说 明 有 个 简单 的 方 
法 ， 就 是 在 产品 功能 清单 精炼 工作 坊 中 举例 说 明 需 求 。 这 不 需要 额外 
的 会 议 或 特别 的 安排 。 只 是 PBR 工 作坊 的 中 间 部 分 有 所 不 同 而 已 。 

Pyxis 技 术 公 司 的 Talia 团 队 就 像 这 样 举办 他 们 的 工作 坊 。André 
Brissette 这 样 解释 这 个 过 程 : 

“通常 在 产品 负责 人 和 Scrum 大 师 发 现 功 能 清单 顶部 的 故事 不 够 详 
细 的 时 候 ， 团 队 会 举办 工作 坊 。 比 如 ， 如 果 有 个 故事 估算 为 20 个 故事 
点 ， 他 们 在 Sprint 中 安排 一 次 维护 工作 坊 。 我 们 认为 每 周 或 每 两 周 做 
一 次 这 样 的 活动 是 个 好 习惯 ， 这 样 可 以 确保 产品 功能 清单 顶部 的 故事 
都 是 容易 直接 拿 来 做 的 。 我 们 查看 故事 的 时 候 ， 产 品 负责 人 和 开发 人 
员 对 其 可 行 性 交换 意见 。 我 们 在 白板 上 画 一 些 例子 ， 找 出 技术 难点 和 
易 用 性 的 问题 ， 然 后 开发 人 员 会 对 范围 做 一 个 评估 或 估量 。 此 时 我 们 
使 用 计划 扑克 。 如 果 大 家 对 功能 范围 和 所 需要 的 工作 量 没 有 意见 ， 那 
它 就 这 样 定 下 来 了 。 如 果 发 现 很 难 达 成 一 致 的 意见 ， 我 们 会 试 着 分 解 
故事 ， 直 到 所 有 内容 都 十 分 清晰 并 且 大 家 都 对 评估 的 工作 量 表示 认 
[Alo ” 

大 型 工作 坊 的 准备 工作 可 能 会 是 个 亚 梦 。 如 果 你 没有 预定 好 日 
期 ， 大 家 可 能 安排 了 别 的 会 议 ， 或 没有 准备 好 讨论 。 而 定期 会 议 可 以 
解决 这 个 问题 。 这 个 做 法 对 想 帮忙 却 又 太 忙 的 高 层 项 目 干 系 人 特别 有 
用 。 (提示 : 致电 他 们 的 秘书 来 安排 工作 坊 。) 

如 果 商 业 用 户 或 利益 相关 者 没有 足够 的 时 间 ， 试 着 去 适应 他 们 的 
时 间 表 ， 或 者 趁 他 们 还 在 房间 里 ， 在 产品 演示 过 程 中 进行 需求 说 明 。 
当 商 业 用 户 和 交付 团队 不 在 一 个 地 方 工作 时 ， 这 种 办 法 也 同样 管用 。 


大 型 工作 坊 可 以 有 效 地 进行 知识 传递 ， 并 建立 整个 团队 对 需求 的 
共识 ， 所 以 我 强烈 建议 那些 打算 使 用 实例 化 需求 说 明 的 团队 采用 大 型 
工作 坊 。 另 一 方面 ， 这 会 消耗 大 家 大 量 的 时 间 。 一 旦 有 了 成 熟 的 过 程 
并 且 团 队 建 立 起 了 领域 知识 ， 你 就 可 以 采取 其 他 更 简单 的 方式 。 

6.2.2 尝试 小 型 工 a 三 剑客 ” 


适用 于 : 需要 频繁 地 澄清 领域 问题 时 

如 果 领 域 逻辑 很 复杂 ， 程 序 员 和 测试 人 员 需 要 频繁 浴 清 ， 那 么 由 
一 个 人 单独 负责 编写 测试 ， 甚 至 还 包括 审核 ， 就 不 是 一 个 好 的 方法 。 

-举办 小 型 的 工作 坊 ， 由 一 个 开发 人 员 ， 一 个 测试 人 员 和 一 个 业 
务 分 析 师 参与 。 

这 样 的 会 议 有 一 个 流行 的 名 字 叫 “神勇 三 剑客 ”。Janet Gregory 和 
Lisa Crispin 在 Agile Testing 一 书 中 提 到 一 个 类 似 的 协作 模型 ， 叫 做 
“三 个 人 的 力量 ”。 〈 过 去 我 称 这 样 的 工作 坊 为 “验收 测试 三 人 行 ”， 后 
来 有 人 抱怨 其 中 有 暗 讽 意 味 ， 于 是 停 用 。 ) 


注释 : (DLisa Crispin 和 Janet Gregory 所 著 的 Agile Testing:A 
Practical Guide for Testers and Agile Teams(Addison-Wesley 
Professional, 2009). 


“神勇 三 剑客 "会议 能 够 从 不 同方 面 获得 恨 好 的 反馈 。 与 大 型 需求 
说 明 工 作坊 相 比 ， 它 不 能 确保 整个 团队 达成 一 致 的 共识 ， 但 是 它 更 容 
易 组 织 ， 并 且 不 需要 预先 计划 。 较 小 的 会 议 也 给 参与 者 的 工作 方式 惠 
去 更 多 的 灵活 性 。 组 织 一 个 围 着 一 人 台 小 型 显示 器 的 大 型 工作 坊 是 没 
意义 的 ， 应 该 是 三 个 人 可 以 舒服 地 坐 着 ， 方 便 地 查看 一 个 大 屏幕 。 

要 想 有 效 地 举办 一 场 “ 神 勇 三 剑客 ”会 议 ， 与 会 的 三 个 人 必须 在 领 
域 问题 上 有 相似 的 理解 。 如 果 他 们 没有 达到 相似 的 理解 ， 可 以 考虑 让 
大 家 在 会 前 做 好 准备 ， 而 不 是 随时 举办 。Ian Cooper 这 样 解释 : 

“组 织 三 方 会 议 的 问题 在 于 ， 如 果 团 队 对 领域 知识 的 理解 存在 不 平 
衡 ， 那 么 对 话 将 会 被 领域 知识 更 强 的 人 所 左右 。 这 和 做 结对 (结对 编 


f=) 时 磁 到 的 问题 类 似 。 领 域 知识 丰富 的 人 倾向 于 掌控 会 谈 。 拥 有 较 
少 领 域 知识 的 人 有 时 会 问 出 一 些 问 题 ， 这 些 问 题 可 能 会 有 许多 有 趣 的 
见解 。 让 他 们 事先 做 些 准备 有 助 于 他 们 在 会 谈 中 提出 问题 。” 


防止 工作 坊 中 遗漏 一 些 信 息 有 个 常用 的 技巧 ， 就 是 做 一 个 类 似 最 

终 需 求 说 明 格式 的 记录 。 像 “神勇 三 剑客 "这样 较 小 的 组 ， 只 要 你 手头 

一 台 显 示 器 和 一 个 键盘 ， 就 可 以 创建 一 个 这 样 的 文件 。Rob Park 曾 
在 一 家 美国 大 型 保险 公司 的 团队 中 工作 ， 他 们 使 用 “神勇 三 剑客 ”来 进 
行 协作 。Park 说 : 

“神勇 三 剑客 ;会 议 的 结果 是 一 份 实际 的 功能 文件 一 一 假定 一 当 一 
那么 (Given-When-Then)。 我 们 不 必 关 心 测试 装置 或 下 面 的 其 他 层 ， 
而 验收 条 件 就 是 结果 。 有 时 不 必 非 常 精确 一 一 例如 ， 我 们 知道 最 好 要 
有 一 个 真实 的 保单 号 ， 我 们 会 先 在 笔记 本 或 某 个 地 方 记录 下 来 ， 而 后 
再 做 整理 。 但 是 主要 的 需求 是 在 为 功能 编写 代码 之 前 ， 要 完成 我 们 一 
致 认同 的 测试 ， 至 少 内 容 要 完成 。” 

TraderMedia 公 司 Stuart Taylor 的 团队 对 每 个 故事 都 有 非 正式 的 沟 
通 ， 然 后 产生 相应 的 测试 。 由 开发 人 员 和 测试 人 员 一 起 完成 。Taylor 
解释 这 个 过 程 说 : 

“ 当 要 开始 一 个 故事 的 时 候 ， 开 发 人 员 会 叫 来 QA 说 :我 准备 要 做 
这 个 故事 了 。 然后 他 们 会 商量 如 何 做 测试 。 开 发 人 员 会 谈论 他 如 何 使 


用 TDD 来 进行 开发 。 例 如 :电话 号 码 字 段 我 会 用 一 个 整 型 ， 紧 接着 QA 
会 说 :“ 那 如 果 我 输入 ++、 括 号 或 以 0 开头 的 字符 又 将 如 何 呢 ? ， 

QA 开始 基于 业务 验收 条 件 编写 (验收 ) 测试 ， 利 用 测试 的 思想 考 
虑 边界 情况 。 这 些 测 试 会 给 BA 和 开发 人 员 看 。 在 演示 的 时 候 我 们 应 该 
能 够 看 到 它们 被 执行 。” 

协作 编写 半 正 式 的 测试 可 以 保证 之 后 进行 自动 化 时 不 会 扭曲 一 些 
信息 。 同 时 它 还 有 助 于 分 享 如 何 使 用 例子 来 编写 良好 的 需求 说 明 ; 只 
有 当 全 组 人 员 围 着 一 个 显示 器 和 键盘 坐 着 的 时 候 才 可 行 。 不 要 尝试 在 
全 体 工 作坊 中 起 章 半 正式 文档， 因为 这 样 不 利于 所 有 人 都 参与 。 

= 对 于 已 经 拥有 良好 目标 领域 知识 和 成 熟 产品 的 团队 ， 他 们 不 必 
举行 会 议 或 单独 的 会 谈 来 讨论 故事 的 验收 条 件 。 开 发 人 员 和 测试 人 员 
不 需要 预先 为 需求 说 明 提 供 太 多 信息 ， 他 们 可 以 在 具体 实现 的 时 候 解 
决 较 小 的 功能 分 歧 。 这 样 的 团队 可 以 用 非 正 式 谈 话 或 评审 的 方式 来 协 
作 。 


6.2.3 结对 编写 


适用 于 : 成 熟 的 产品 

即使 在 某 些 情况 下 ， 开 发 人 员 有 足够 多 的 信息 而 无 需 大 型 工作 坊 
就 可 以 开展 工作 ， 团 队 依然 发 现 协作 编写 带 实 例 的 需求 说 明 非 常 有 帮 
助 。 

-分 析 师 可 以 提供 正确 的 行为 ， 而 开发 人 员 知 道 编写 测试 的 最 佳 
方式 ， 这 样 之 后 就 可 以 很 容易 地 进行 自动 化 并 融入 到 活 文档 系统 的 其 
余部 分 中 。 

在 BNP Paribas, Andrew Jackman 的 团队 正在 参与 一 个 比较 成 熟 的 
产品 。 他 们 使 用 过 不 同 的 方式 去 编写 测试 ， 并 得 出 结论 说 业务 分 析 师 
和 开发 人 员 都 需要 参与 到 测试 编 瑟 中 。Andrew 说 : 

“开发 人 员 编 写 测试 的 时 候 ， 很 容易 误解 故事 的 内 容 。 如 果 没 有 与 
业务 分 析 师 交流 ， 那 只 是 开发 人 员 的 单方 面 见解 。 而 如 果 让 业务 分 析 
师 编写 测试 ， 又 完全 是 另外 一 回 事 了 。 当 他 们 编写 故事 时 ， 这 个 故事 
可 能 会 影响 许多 已 有 的 测试 ， 但 是 他 们 却 无 法 预见 到 。 业 务 分 析 师 喜 


欢 在 一 个 测试 中 展现 单个 故事 的 流程 。 一 般 来 说 ， 这 会 导致 大 量 的 重 
复 ， 因 为 流程 的 大 部 分 是 一 样 的 。 因 此 我 们 把 部 分 流程 挪 到 他 们 自己 
的 测试 中 。>” 

有 些 团队 ， 特 别 是 那些 没有 业务 分 析 师 或 业务 分 析 师 是 瓶颈 的 团 
队 ， 我 们 就 让 测试 人 员 和 开发 人 员 一 起 结对 编写 测试 。 这 能 够 让 测试 
人 员 了 解 到 哪些 会 被 可 执行 的 需求 说 明和 有 覆 盖 到 ， 同 时 帮助 他 们 理解 哪 
些 需要 单独 检查 。SongKick 的 团队 就 是 一 个 很 好 的 例子 。Phil Cowans 
这 样 解释 他 们 的 过 程 : 

“并 不 是 QA 为 开发 人 员 编 写 (验收 ) 测试 ; 而 是 他 们 一 起 来 完 
成 。QA 在 功能 交付 之 前 一 直 负 责 需求 说 明 ， 表 现 为 QA 负责 测试 计 
划 。 开 发 人 员 和 QA 一 起 编写 功能 文件 (需求 说 明 ) ，QA 会 建议 应 该 
覆盖 哪些 部 分 。QA 寻 找 功能 文件 的 漏洞 ， 指 出 未 被 覆盖 的 功能 ， 同 时 
也 会 编写 手工 测试 用 的 测试 脚本 。” 

要 想 同 时 考虑 测试 的 几 个 不 同方 面 并 避免 井 蛙 之 见 ， 结 对 编写 需 
求 说 明 是 一 种 廉价 而 又 有 效 的 方式 。 它 能 让 测试 人 员 了 解 编写 需求 说 
明 的 最 佳 方式 ， 以 便 让 需求 说 明 更 容易 自动 化 ， 同 时 还 可 以 让 开发 人 
员 了 解 那些 需要 特别 注意 的 、 有 较 高 风险 的 功能 区 域 。 


适用 于 : 分 析 师 编写 测试 时 

-让 资深 的 开发 人 员 审 查 需求 说 明 。 

Bekk 咨 询 公 司 和 商业 用 户 一 起 研发 挪威 的 奶牛 记录 系统 ， 他 们 编 
与 验收 测试 的 时 候 没 有 与 开发 人 员 一 起 工作 ， 但 是 经 常 让 开发 人 员 来 
审查 他 们 的 测试 。 据 Bekk 公 司 的 资深 开发 人 员 Mikael Vik 说 ， 这 种 方 
法 给 他 们 审 来 了 同样 有 效 的 结果 : 

“我 们 总 是 和 他 们 (商业 用 户 ) 密切 舍 作 来 定义 Cucumber 测 试 。 
当 他 们 拿 着 用 户 故 事 开始 编写 Cucumber 测 试 时 ， 他 们 总 是 会 来 问 我 
们 这 些 测试 是 否 可 行 。 我 们 告诉 他 们 如 何 编写 步 又， 同时 还 会 给 他 们 
一 些 建议 ， 让 他 们 了 解 如 何 扩 展 Cucumber 领 域 语言 以 便 更 有 效 地 表 
达 测 试 的 意图 。>” 

如 果 开 发 人 员 没 有 参与 编写 需求 说 明 ， 他 们 可 以 花 更 多 的 时 间 来 
实现 功能 。 注 意 这 会 增加 风险 ， 导 致 需求 说 明 缺 少 实现 所 需 的 全 部 信 
息 ， 或 者 难以 自动 化 。 


6.2.5 党 正 


适用 于 : 商业 项 目 干系 人 随时 都 在 的 时 候 

如 果 团 队 有 足够 奢侈 的 环境 ， 商 业 用 户 和 项 目 干 系 人 都 坐 在 附近 
(并 且 有 空 回答 问题 ) ， 他 们 就 可 以 通过 临时 的 非 正 式 对 话 获 得 不 错 
的 效果 。 任 何 与 故事 相关 的 人 员 都 可 以 在 开始 实现 故事 之 前 进行 简短 
的 会 谈 ， 而 不 用 举办 预先 安排 的 大 型 工作 坊 。 

-只 要 有 任务 相关 的 人 员 参 加 非 正式 的 交谈 就 足够 了 ， 这 样 就 可 

以 对 所 需 完成 的 内 容 建立 起 清晰 的 定义 。 

“任何 相关 人 人员” 包括 如 下 几 种 : 

调查 故事 的 分 析 师 ; 

实现 故事 的 程序 员 ; 

做 手工 探索 性 测试 的 测试 员 ; 

最 终 从 结果 中 获 利 或 使 用 软件 的 用 户 ， 丙 业 项 目 干 系 人 。 

非 正式 交谈 的 目的 是 要 确保 参与 其 中 的 所 有 人 对 故事 都 有 相同 的 
理解 。 在 LMAX， 这 样 的 交谈 出 现在 一 个 Sprint 的 前 几 天 。Jodie Parker 


解释 道 : 

“根据 实际 情况 决定 是 否 需 要 交谈 。 你 已 经 有 了 自己 的 想法 和 草 
图 ， 并 且 确 实 知道 如 何 实现 它 。 如 果 还 未 编写 验收 测试 ， 开 发 人 员 和 
测试 人 员 可 以 一 起 结对 来 写 。 如 果 没 有 进行 交谈 ， 那 么 最 后 只 是 “做 
了 ;而 非 ( 做 对 了 ?。>” 

有 些 团 队 ， 比 如 像 uSwitch.com 的 团队 ， 他 们 没有 试图 一 下 子 确定 
所 有 的 验收 标准 ， 而 是 确立 了 一 个 通用 的 底线 ， 并 且 给 测试 人 员 和 开 
发 人 员 足 够 多 的 信息 ， 以 便 他 们 开始 工作 。 因 为 和 商业 用 户 坐 得 很 
近 ， 他 们 可 以 在 需要 时 随时 展开 短暂 的 交谈 ( 详 见 第 12 章 ) 。 

有 些 团 队 根 据 故事 引入 的 变更 的 类 型 来 决定 是 做 非 正 式 的 讨论 还 
是 进行 大 型 的 需求 说 明 工 作坊 。 诺 基 亚 西门 子 的 IsmoAro 使 用 下 面 这 
种 方法 : 

“我 们 同意 使 用 ATTD 测 试用 例 (需求 说 明 ) ， 而 无 需 开会 。 如 果 
团队 觉得 这 样 做 容易 些 ， 他 们 可 以 不 用 开会 。 如 果 故 事 的 实现 难度 看 
起 来 比较 大 ， 需 要 其 他 项 目 干系 人 的 意见 ， 他 们 也 可 以 组 织 一 个 
ATDD 会 议 (需求 说 明 工 作坊 ) 。 这 样 做 的 前 提 是 团队 对 领域 知识 很 
了 解 。 当 你 要 在 一 个 老 的 功能 上 加 点 东西 时 ， 就 更 容易 找 出 测试 用 
Fil, ” 


= 


你 认为 | 


6.3 准备 协作 


协作 制定 需求 说 明 是 一 种 非常 好 的 方法 ， 可 以 确保 大 家 达成 共 
识 ， 并 可 以 帮助 我 们 考虑 到 错综复杂 的 、 独 自 思考 时 无 法 想到 的 细 
节 。 如 果 讨 论 的 话题 需要 大 量 的 事先 分 析 ， 或 团队 成 员 的 知识 水 平 参 
差 不 齐 ， 那 么 从 头 开始 讨论 就 是 低 效 并 且 令 人 诅 形 的 。 要 解决 这 个 问 
题 ， 很 多 团队 引入 了 一 个 准备 阶段 ， 如 图 6-1 所 示 ， 以 此 确保 功能 描述 
得 足够 详细 ， 从 而 有 利于 进行 一 场 高 效 的 讨论 。 


开始 有 关 例 子 的 工作 
提前 两 周 提前 几 天 迭代 启动 内 部 迭代 ss 
详细 分 析 所 需 的 收集 /回答 关键 的 重新 协商 爆发 出 的 严重 的 流程 干扰 的 
足够 信息 开放 性 问题 问题 风险 


图 6-1 通常 根据 团队 何 时 开始 编写 例子 ， 可 以 把 它们 归纳 成 4 组 。 那 些 
需要 更 多 时 间 来 分 析 和 讨论 开放 性 问题 的 团队 可 以 早点 开始 


准备 工作 包含 与 上 游 项 目 干系 人 一 起 准备 一 些 初始 的 例子 与 分 
析 。 根 据 团队 成 员 的 具体 情况 ， 可 以 由 一 个 人 (通常 是 分 析 师 的 角色 ) 
或 者 一 小 部 分 资深 人 员 来 完成 。 


适用 于 : 项 目 有 众多 项 目 干 系 人 时 

有 众多 项 目 干 系 人 的 团队 (例如 ， 当 软件 使 用 者 涉及 公司 多 个 音 
门 ， 或 者 软件 需求 是 由 多 个 外 部 的 客户 所 驱动 的 ) ， 一 般 来 说 你 需要 
在 迭代 开始 前 几 天 举办 介绍 会 。 有 些 团队 把 这 个 会 议 叫 做 预先 计划 会 
议 。 

-介绍 会 的 目的 是 为 即将 要 做 的 故事 收集 一 些 初 始 的 反馈 ， 并 从 
计划 中 筛选 掉 一 些 需 求 模糊 不 清 的 故事 。 

介绍 会 的 目的 并 不 是 为 了 得 到 精炼 的 需求 说 明 ， 而 是 给 团队 提供 
足够 的 时 间 ， 对 那些 可 以 快速 定位 的 关键 问题 来 收集 外 部 反馈 。 这 不 
是 迭代 计划 会 议 或 Scrum 计 划 会 议 。 在 sprint 开 始 前 几 天 举办 介绍 会 ， 
队 就 有 机 会 在 真正 提炼 需求 说 明 或 计划 会 议 之 前 和 外 部 的 项 目 干系 
人 一 起 讨论 一 些 开 放 性 的 问题 。 

许多 团队 在 介绍 会 上 定义 高 层次 的 验收 标准 ， 使 用 简单 的 列表 而 
非 详 细 的 实例 。 通 过 找 出 测试 的 基础 用 例 ， 可 以 帮助 我 们 关注 以 后 的 
TF 

有 些小 团队 ， 如 ePlan Services 的 团队 ， 开 发 人 员 、 项 目 干系 人 、 
项 目 经 理 和 产品 负责 人 都 会 参加 这 个 介绍 会 。 对 于 大 型 团队 或 团队 群 
组 ， 只 会 有 小 部 分 人 参加 。 在 天 空 网 络 服务 部 门 ， 有 6 个 团队 ， 每 个 团 
队 会 派 两 三 个 人 参加 。 

6.3.2 邀请 


协作 制定 需求 说 明 的 过 程 之 所 以 有 效 ， 是 因为 它 让 需求 说 明 进入 
到 丙 业 用 户 和 开发 团队 成 员 这 个 集体 的 大 脑 中 ， 确 保 他 们 对 需求 说 明 
有 相同 的 理解 。 


许多 团队 邀请 他 们 的 业务 分 析 师 或 产品 负责 人 参与 讨论 ， 但 是 他 
们 却 没 有 邀请 客户 项 目 干系 人 。 在 这 些 案例 中 ， 团 队 交 付 的 产品 都 达 
到 了 业务 分 析 师 或 产品 负责 人 的 期 望 ， 但 是 这 些 期 望 往往 不 是 最 终 用 
户 想 要 的 。 在 我 看 来 ， 业 务 分 析 师 是 交付 团队 的 一 部 分 ， 而 非 客 户 代 
表 。 

-要 获得 最 佳 效 果 ， 实 际 的 项 目 干系 人 都 要 参与 到 协作 需求 说 明 
中 。 他 们 是 真正 能 做 决定 的 那些 人 。 

当 项 目 有 许多 利益 相关 方 时 ， 我 们 往往 只 通过 一 个 人 来 获得 所 有 
的 需求 ， 一 般 这 个 人 叫做 产品 负责 人 。 这 种 做 法 对 确定 范围 和 优先 级 
很 有 效 ， 但 对 需求 说 明 却 不 是 这 样 。 在 ePlan Services 公 司 ，Lisa 
Crispin 的 团队 就 全 到 了 这 个 问题 。 她 说 : 

“产品 负责 人 需要 负责 所 有 的 事 ， 但 是 他 又 不 能 同时 把 所 有 的 事情 
都 做 好 ， 因 为 他 在 做 三 四 个 人 的 工作 。 没 有 人 能 做 所 有 的 事情 。 有 时 
我 们 需要 一 个 答案 才能 完成 一 个 故事 ， 但 是 他 无 法 提供 答案 ， 比 如 ， 
他 不 理解 会 计 需 求 。 我 们 还 是 需要 直接 和 项 目 干系 人 交流 才能 理解 这 
些 问 题 。 

他 觉得 我 们 绕 过 了 他 ， 这 样 我 们 不 得 不 寻找 一 个 平衡 点 ， 既 要 让 
产品 负责 人 知晓 又 要 从 使 用 该 功能 的 用 户 那 里 获取 到 信息 。 如 果 两 边 
存在 差异 ， 我 们 还 得 让 他 们 一 起 讨论 该 问题 。” 

一 个 人 不 可 能 完全 了 解 所 有 的 事情 。 但 是 优先 级 必须 只 由 一 个 人 
来 确定 ， 一 旦 选择 了 高 优先 级 的 故事 ， 团 队 必 须 开 始 和 相关 的 项 目 干 
系 人 一 道 为 特定 的 故事 进行 协作 ， 制 定 需求 说 明 。 在 Practice for 
Scaling Lean and Agile 一 书 中 ，Larman 和 Vodde 区 别 对 待 需求 澄清 和 优 
先 级 排列 。 他 们 认为 优先 级 必须 由 一 个 人 来 决定 ， 但 是 澄清 需求 必须 
由 团队 自己 来 完成 。 

即使 团队 认为 他 们 十 分 了 解 领域 知识 ， 自 己 能 够 制定 出 好 的 需求 
说 明 来 ， 邀 请 最 终 的 项 目 干 系 人 一 起 参与 还 是 很 重要 的 。Mike Vogel 
参与 了 一 个 扩 术 数据 管理 项 目 ， 该 项 目的 开发 人 员 对 领域 知识 和 技术 
限制 的 了 解 都 要 比 最 终 用 户 好 。 迫 于 进度 压力 ， 他 们 经 常 在 协作 制定 


需求 说 明 时 限制 或 排除 项 目 干 系 人 ，Vogel 认 为 这 是 他 们 的 一 个 最 大 错 
误 。 他 说 : 

“起 初 我 们 自己 做 了 太 多 测试 创建 和 验收 标准 定义 的 工作 。 所 以 我 
们 建立 起 了 元 编程 ， 它 可 以 更 加 快速 地 推进 系统 的 开发 ， 并 让 我 们 处 
于 很 大 的 进度 压力 之 下 。 但 是 总 会 有 一 些 细微 之 处 ， 我 们 和 客户 都 不 
理解 ， 这 些 都 没 能 在 测试 中 涵盖 。>” 


如 果 可 能 ， 还 是 要 邀请 真正 的 项 目 干系 人 进入 到 协作 制定 需求 说 
明 的 过 程 中 。 这 将 保证 你 能 从 权威 或 可 靠 的 来 源 获得 正确 的 信息 ， 减 
少 预先 分 析 的 必要 性 。 

在 大 型 组 织 中 ， 这 可 能 需要 一 些 说 服 和 政治 活动 ， 但 这 是 绝对 值 
得 的 。 如 果 你 的 团队 有 同样 的 问题 ， 那 么 请 与 产品 负责 人 一 起 寻找 一 
种 可 以 直接 和 项 目 干系 人 沟通 的 方式 ， 并 且 不 要 云 干涉 产品 负责 人 作 
为 项 目 干系 人 的 管理 责任 。 


6.3.3 进行 准备 工 查 


适用 于 : 项 目 干系 人 远离 团队 时 

~ 项 目 干系 人 远离 团队 的 时 候 ， 团 队 至 少 应 该 有 一 个 人 负责 事先 
准备 具体 的 实例 。 

在 我 采访 的 团队 中 ， 先 于 团队 开始 工作 的 人 一 般 是 业务 分 析 师 或 
测试 人 员 。 他 们 和 项 目 干 系 人 一 起 分 析 需 求 ， 商 量 实例 的 结构 ， 为 最 


重要 的 用 例 捕获 价值 。 团 队 碰 到 不 明确 的 需求 ， 需 要 大 量 的 分 析 和 说 
明 时 ， 也 需要 有 一 个 人 来 做 事先 工作 。 

在 大 多 数 团 队 中 ， 开 发 人 员 也 会 尽早 地 审查 初始 的 实例 从 而 提供 
一 些 技术 上 的 反馈 。 这 保证 团队 能 在 早期 发 现 大 多 数 的 功能 分 上 民 和 问 
题 。 项 目 干系 人 可 以 事先 回答 这 些 问题 ， 这 样 团 队 一 起 审查 故事 的 时 
候 就 不 会 陷入 僵局 。 

许多 团队 刚 开 始 时 就 在 这 一 步 失败 了 ， 特 别 是 当 采 用 了 固定 迭代 
长 度 的 过 程 时 。 一 个 故事 涉及 的 所 有 内 容 都 应 当 在 一 个 Sprint 或 一 个 迭 
代 中 完成 ， 这 看 起 来 很 合乎 逻辑 。 如 果 领 域 比较 复杂 ， 将 需求 说 明和 
开发 限制 在 一 个 迭代 内 完成 ， 会 导致 开发 人 员 频 繁 地 陷入 困境 。 

BNP Paribas 的 Sierra 团 队 尝 试 把 所 有 事情 都 限制 在 一 个 迭代 内 ， 但 
他 们 发 现 这 种 方式 无 法 使 团队 高 效 地 工作 。 后 来 ， 他 们 的 业务 分 析 师 
尝试 在 团队 开工 之 前 就 开始 工作 。Andrew Jackman 说 : 

“我 们 的 项 目 经 理 ， 实 际 上 是 产品 负责 人 ， 他 会 事先 准备 所 要 完成 
的 故事 。 他 和 业务 分 析 师 会 准备 好 下 一 轮 迭 代 所 要 的 故事 以 备 在 会 上 
讨论 ， 业 务 分 析 师 会 准备 好 验收 测试 。 我 们 过 去 并 不 是 这 么 做 的 ， 而 
是 当 开发 人 员 试 着 编写 (验收) 测试 时 ， 我 们 会 突然 询问 一 些 问题 ， 
然后 发 现 我 们 还 缺少 分 析 。>” 

在 迭代 之 前 把 初始 的 实例 放 在 一 起 ， 可 以 让 团队 成 员 更 好 地 为 一 
起 讨论 做 好 准备 。 在 Beazley，Ian Cooper 的 团队 就 使 用 这 样 的 方式 。 
他 们 的 业务 分 析 师 和 项 目 干 系 人 都 在 美国 ， 但 是 开发 团队 却 在 英国 。 
他 说 : 

“由 于 产品 本 身 以 及 我 们 为 美国 客户 服务 ， 时 区 成 了 一 个 大 问题 ， 
我 们 很 难 接触 到 客户 。 业 务 分 析 师 们 只 是 个 代理 ， 他 们 经 常 碰 到 问题 
无 法 立刻 给 出 答案 的 情况 。 开 发 人 员 知 道 许多 领域 知识 ， 所 以 分 析 师 
和 开发 人 员 是 主导 人 员 。 测 试 人 员 并 没有 真正 参与 进来 。 

我 们 发 现 让 分 析 师 先 过 一 遍 需 求 再 来 参加 会 议 ， 事 情 将 会 简单 很 
多 。 测 试 人 员 往 往 会 测试 所 有 的 可 能 场景 ， 询 问 一 些 边界 用 例 。 测 试 


人 员 会 获得 更 多 的 时 间 去 阅读 与 理解 需求 ， 思 考 可 能 出 现 的 问题 。 这 
让 他 们 可 以 更 好 地 参与 进来 。” 

如 果 项 目 干系 人 不 能 参与 到 需求 说 明 的 协作 制定 中 ， 那 么 这 将 大 
大 提高 交付 团队 误解 目标 的 风险 。 为 了 降低 风险 ， 远 离 用 户 的 团队 要 
比 可 以 直接 接触 商业 用 户 的 团队 做 更 多 的 事先 分 析 。 如 果 要 这 么 做 ， 
就 需要 分 析 师 在 上 游 与 商业 用 户 和 项 目 干系 人 一 起 进行 工作 ， 团 队 其 
他 成 员 则 需要 接管 一 些 分 析 师 的 下 游 工 作 。 

如 果 决 定 采 用 和 迭代 前 分 析 ， 请 确保 这 项 工作 由 某 个 专门 的 队员 来 
做 ， 这 样 可 以 避免 使 整个 团队 受到 牵连 ， 同 时 也 解决 了 故事 必须 在 一 
个 迭代 内 完成 的 问题 。 

6.3.4 1 员 尽 早 审查 


适用 于 : 分 析 师 /领域 专家 成 为 瓶颈 时 

如 果 分 析 师 或 领域 专家 成 了 过 程 的 瓶颈 ， 他 们 将 无 法 带领 团队 进 
行 迭 代 前 分 析 。 当 项 目 干 系 人 有 办 法 回 舍 问题 或 者 产品 已 经 很 成 熟 的 
时 候 ， 这 或 许 不 成 问题 ， 开 发 晚期 不 会 出 现 功 能 分 歧 。 

但 另 一 方面 ， 如 果 团 队 发 现 他 们 没有 足够 的 信息 来 编写 可 执行 的 
需求 说 明 ， 融 得 有 人 能 较 早 地 提供 分 析 。 这 个 人 不 必 是 业务 分 析 师 或 
领域 专家 ， 他 可 以 是 测试 人 员 或 开发 人 员 。 


-开发 人 员 和 测试 人 员 可 以 帮助 领域 专家 减轻 负担 〈 当 领域 专家 
成 为 瓶颈 时 ) ， 他 们 可 以 做 第 一 遍 审 查 来 找 出 常见 的 问题 。 这 样 将 提 
高 团队 整体 的 输出 ， 同 时 也 有 助 于 构建 跨 功 能 团队 。 

Clare McLennan 参 与 了 一 个 网 页 广告 项 目 ， 这 个 项 目的 项 目 干系 
人 在 德国 ， 而 团队 在 新 西 兰 一 一 几乎 整整 12 个 小 时 的 时 差 。 测 试 人 员 
扮演 了 本 地 分 析 师 的 角色 。 他 们 不 能 替 客 户 做 决定 ， 所 以 他 们 先 于 团 
队 开 始 工 作 。McLennan 说 : 

“为 了 避免 时 区 问题 ， 我 们 不 得 不 确保 每 个 故事 都 要 在 控制 当中 。 
如 果 测 试 人 员 看 过 后 觉得 没有 问题 ， 那 么 他 们 会 再 找 一 个 程序 员 去 看 
看 ， 确 保 程序 员 也 觉得 没 问题 。” 

在 Ultimate 软件 公司 的 Global Talent Management 团 队 ， 产 品 负 责 人 
很 忙 ， 团 队 其 他 人 员 会 帮忙 做 分 析 工 作 。2 个 开发 人 员 和 1 名 测试 人 员 
组 成 的 小 组 会 事先 审查 每 个 故事 ， 找 出 需要 咨询 的 问题 ， 为 与 产品 负 
责 人 开会 做 好 准备 。Maykel Suarez 说 这 种 方式 帮助 他 们 更 有 效 地 利用 
了 大 家 的 时 间 : 

“大 一 点 的 团队 ， 比 如 17 人 左右 ， 他 们 做 决定 有 很 大 的 压力 。 解 决 
办 法 是 分 小 组 。 现 在 一 个 小 组 (包括 1 个 测试 人 员 、2 个 开发 人 员 ) 能 
够 更 快 地 做 出 决定 。 在 这 些 准备 会 议 中 ， 我 们 会 讨论 小 于 两 个 星期 迭 
代 的 工作 ， 一 般 只 是 两 三 个 故事 。 因 此 ， 每 隔 3 人 5 天 有 3 个 人 开 一 个 15 
一 30 分 钟 的 会 议 并 不 浪费 时 间或 资源 。” 


6.3.5 只 准备 初始 的 实例 


适用 于 : 项 目 干系 人 都 有 空 的 时 候 

项 目 干系 人 都 有 空 回 谷 问题 时 ， 团 队 不 需要 花 太 多 的 时 间 事 先 准 
备 详细 的 实例 。 但 他 们 发 现 ， 为 了 在 讨论 前 获取 到 基本 的 结构 ， 确 定 
一 些 初始 的 实例 仍然 是 非常 有 用 的 。 

= 确定 初始 的 实例 能 帮助 我 们 获得 需求 说 明 的 基本 结构 ， 并 可 以 
让 讨论 更 加 高 效 。 

在 Pyxis 技 术 公 司 的 Talia 项 目 中 ，André Brissette 经 常 使 用 外 部 客 
户 提 供 的 实例 来 进行 需求 说 明 。 他 是 开发 团队 的 商业 项 目 干系 人 ， 也 


和 外 部 客户 一 起 工作 。 当 客户 提出 新 的 功能 时 ， 他 们 把 系统 应 如 何 工 
作 的 实例 发 给 他 ， 这 些 实例 会 成 为 将 来 需求 说 明 的 一 部 分 。 

uSwitch 的 团队 和 他 们 的 项 目 干 系 人 在 同一 地 点 工作 ， 因 而 他 们 无 
需 大 量 的 事先 准备 。 团 队 里 任何 人 都 可 以 在 站 立会 议 中 提出 一 个 新 的 
故事 ， 提 出 建议 的 人 往往 会 先 准备 基本 的 实例 。 

一 开始 融 准 备 好 初始 的 实例 可 以 使 讨论 更 加 高 效 ， 因 为 当 团队 说 
明 一 个 需求 或 确定 关键 属性 时 ， 不 必 尝 试 使 用 结构 最 好 的 实例 。 他 们 
可 以 更 加 专注 在 如 何 理解 并 扩展 初始 的 实例 上 。 


6.3.6 让 过 ) arih 


准备 阶段 应 该 是 为 了 让 协作 更 加 高 效 ， 而 不 是 用 来 代替 协作 的 。 
因为 测试 人 员 是 从 组 合 功能 性 回归 检测 的 角度 来 看 待 可 执行 的 需求 说 
明 ， 所 以 有 些 团 队 事先 准备 的 信息 太 多 了 ， 他 们 找 出 了 测试 中 输入 参 
数 所 有 可 能 的 组 合 。 

-复杂 的 需求 说 明 难 以 理解 ， 所 以 大 多 数 人 在 这 些 需 求 说 明 中 发 
现 不 了 功能 分 歧 以 及 不 一 致 的 地 方 。 

使 用 复杂 的 需求 说 明 ， 事 先 分 析 的 效果 就 如 同 传统 需求 从 分 析 师 
传递 到 开发 人 员 一 样 。 开 发 人 员 只 是 拿 到 需求 ， 而 非 协作 构建 共识 ， 
这 将 导致 误解 的 产生 ， 而 且 很 有 可 能 到 过 程 晚期 才 发 现 功能 分 必 。 

在 LMAX，Jodie Parker 的 团队 准备 过 头 了 ， 最 终 得 到 的 实例 看 起 
来 很 完整 。 这 使 得 他 们 直接 跳 过 了 讨论 ， 最 终 导 致 了 需求 说 明 的 功能 
分 歧 。Parker 建 议事 先 准 备 的 实例 只 要 做 到 “刚刚 好 ”就 行 了 : 

“因为 我 们 都 是 第 一 次 接触 这 个 过 程 ， 一 开始 我 们 的 开发 人 员 说 没 
有 足够 的 信息 进行 工作 。 然 后 业务 分 析 师 非常 完整 地 说 明了 一 切 ， 我 
们 的 手脚 就 被 束缚 了 。 当 开始 照 着 卡片 进行 开发 时 ， 完 全 没有 创新 ， 
无 法 使 用 更 简单 的 解决 方案 ， 因 为 需求 说 明 规 定 得 太 多 了 。 

如 果 你 看 了 一 张 卡片 后 说 “好 吧 ， 我 完全 理解 了 '， 然 后 你 就 胸 有 
成 竹 地 去 工作 ， 你 可 能 已 经 做 了 一 百 万 个 假设 。 如 果 你 看 了 一 张 卡 
片 ， 心 里 全 都 是 我 不 是 很 确定 ;， 这 会 促使 你 去 沟通 ， 在 迭代 开始 时 
提出 来 ， 然 后 讨论 各 种 不 同 的 实现 及 其 效果 。 然 后 ， 测 试 人 员 会 考虑 


它 会 如 何 影响 测试 ; 业务 分 析 师 会 考虑 后 面 的 问题 ， 看 看 是 否 行 的 
通 。‘ 刚 刚好 ;意味 着 开发 人 员 、 业 务 分 析 师 和 测试 人 员 都 站 在 白板 
前 ， 讨 论 应 该 如 何 实现 。” 

不 管 你 是 否决 定 让 某 个 人 提前 花 一 个 星期 去 准备 初始 的 实例 ， 或 
准备 一 个 介绍 会 议 来 找 出 问题 ， 请 记 住 ， 它 的 目的 是 为 了 之 后 的 讨论 
做 准备 ， 而 不 是 为 了 替代 它 。 


6.4 i y 


我 并 不 认为 有 一 种 放 之 四 海 而 上 皆 准 的 原则 能 帮助 你 为 团队 选择 最 
好 的 模型 ， 包 括 实现 个 人 的 事先 工作 与 更 多 的 动手 协作 之 间 的 平衡 。 
在 比较 了 使 用 类 似 过 程 的 团队 后 ， 我 认为 你 的 决定 可 以 基于 以 下 条 
件 : 

产品 的 成 熟 度 如 何 ? 

团队 拥有 多 少 领域 知识 ? 

典型 的 更 改 需要 多 少 分 析 ? 

商业 用 户 和 开发 团队 有 多 近 ? 他 们 是 否 有 空 讨论 并 验证 实例 ? 

过 程 中 的 瓶颈 在 哪儿 ? 

不 成 熟 的 产品 需要 大 型 的 工作 坊 和 大 量 的 事先 分 析 。 对 于 不 成 熟 
的 产品 ， 让 测试 人 员 和 开发 人 员 更 积极 地 帮助 定义 需求 说 明 很 重要 ， 
因为 底层 系统 变化 频繁 ， 而 这 些 人 员 拥 有 商业 用 户 所 没有 的 洞察 力 。 

成 熟 产品 可 以 有 较 少 的 事先 分 析 ， 可 以 考虑 其 他 的 协作 模型 。 成 
熟 产品 可 能 意味 着 较 少 的 意外 。 业 务 分 析 师 和 产品 负责 人 大 多 十 分 了 
解 技术 能 给 他 们 带 来 什么 ， 而 且 他 们 可 以 事先 很 好 地 准备 实例 。 

如 果 团 队 比较 新 或 测试 人 员 和 开发 人 员 对 商业 领域 的 知识 了 解 得 
不 够 ， 那 么 做 大 型 工作 坊 就 比较 值得 。 在 把 商业 领域 知识 有 效 传授 给 
整个 团队 方面 ， 全 体 工 作坊 是 一 个 非常 好 的 方式 。 一 旦 团队 更 好 地 理 
解 了 商业 领域 ， 那 么 小 型 的 、 比 较 专 注 的 讨论 可 能 就 足够 了 。 

如 果 典 型 的 更 改 需要 大 量 的 分 析 ， 那 么 应 该 有 个 担任 分 析 师 角色 
的 人 先 于 团队 与 项 目 干系 人 一 起 准备 详细 的 实例 。 否 则 ， 工 作坊 中 的 


讨论 都 会 结束 得 很 快 ， 并 留 下 大 量 未 解决 的 问题 。 如 果 要 开发 的 是 相 
对 较 小 且 能 够 被 充分 理解 的 功能 ， 那 么 事先 准备 一 些 基础 实例 来 让 讨 
CBA, ARE EH T o 

相 比 有 商业 用 户 随 时 有 空 回 爸 问 题 的 团队 ， 那 些 没 有 与 商业 用 户 
在 一 起 的 团队 通常 需要 更 多 的 事先 工作 。 如 果 丙 业 用 户 根 本 无 法 参加 
需求 说 明 工作 坊 ， 那 就 需要 事先 找 出 更 多 的 问题 与 功能 分 上 层 ， 并 加 以 
处 理 。 

最 后 ， 为 已 经 成 为 过 程 瓶 有 颈 的 团队 成 员 增 加 更 多 的 工作 是 完全 疫 
有 意义 的 。 测 试 是 瓶颈 的 团队 应 该 让 开发 人 员 和 业务 分 析 师 更 多 地 参 
与 到 事先 工作 中 。 类 似 地 ， 业 务 分 析 师 或 领域 问题 专家 是 瓶颈 的 团队 
应 该 让 测试 人 员 帮 助 完成 事先 的 分 析 工 作 。 


6.5 铭记 


实例 化 需求 说 明 非 常 依赖 于 商业 用 户 和 交付 团队 成 员 之 间 的 协 
作 。 

交付 团队 的 所 有 人 都 要 对 需求 说 明 的 正确 性 负责 。 开 发 人 员 和 测 
试 人 员 必 须 提供 关于 技术 实现 和 验证 方面 的 建议 。 

大 多 数 团队 协作 制定 需求 说 明 分 为 两 个 阶段 : 有 人 事先 准备 功能 
的 初始 实例 ;然后 该 功能 的 项 目 干系 人 进行 讨论 ， 并 添加 实例 来 澄清 
或 完成 需求 说 明 。 

事先 准备 工作 与 协同 工作 之 间 的 平衡 ， 要 根据 以 下 几 个 因素 来 
E: 产品 的 成 熟 度 、 交 付 团 队 的 领域 知识 水 平 、 典 型 更 改 需 求 的 复杂 
上 度 、 过 程 瓶颈 以 及 商业 用 尸 是 否 有 空 。 


第 7 章 举例 说 明 
例子 既 能 避免 歧义 又 是 进行 准确 沟通 的 好 方法 。 在 日 常 的 交谈 和 


写作 中 ， 我 们 会 不 假 思索 地 使 用 例子 。 当 我 在 Google 里 搜索 “例如 ”这 
个 词组 时 ， 返 回 的 搜索 结果 超过 了 2.1 亿 页 。 


使 用 传统 的 需求 说 明 时 ， 例 子 会 在 软件 开发 过 程 中 时 隐 时 现 。 业 
务 分 析 师 通常 会 从 商业 用 户 那 里 获取 到 订单 、 发 货 单 以 及 报表 的 样 
本 ， 然 后 他 们 会 将 其 转换 成 抽象 的 需求 。 开 发 人 员 会 想 出 一 些 例子 来 
解释 边界 情况 并 向 商业 用 户 或 分 析 师 作出 澄清 ， 而 后 他 们 会 将 其 转化 
成 代码 ， 但 他 们 并 不 会 记录 下 这 些 例 子 。 测 试 人 员 会 设计 出 测试 用 
例 ， 它 们 实际 上 就 是 系统 应 当 如 何 工作 的 实例 ;这些 例 子 仪 供 他 们 自 
己 使 用 ， 而 不 会 拿 来 与 开发 人 员 或 分 析 师 进行 沟通 。 

每 个 人 都 会 创造 自己 的 例子 ， 且 不 说 这 些 例 子 是 否 完整 ， 连 例子 
的 一 致 性 都 无 法 确保 。 这 就 是 为 什么 在 软件 开发 中 最 终结 果 往 往 会 背 
离 最 初 设想 的 原因 。 为 了 避免 这 种 情况 ， 我 们 必须 防止 不 同 角色 之 间 
出 现 的 误解 ， 只 维护 一 处 事实 来 源 。 

例子 是 避免 沟通 问题 的 好 工具 。 如 果 我 们 目 始 至 终 都 能 够 捕获 所 
有 的 例子 ， 并 在 分 析 、 开 发 和 测试 中 一 致 地 使 用 它们 ， 那 么 我 们 就 可 
以 避免 进入 传 话 游戏 中 〈 而 导致 信息 失真 ) 。 

Beazley 公 司 引 入 实例 化 需求 说 明 的 时 候 ，Marta Gonzalez Ferrero 
是 当时 的 测试 负责 人 。 据 她 所 述 ， 开 发 团队 承诺 的 工作 量 超出 了 他 们 
的 能 力 ， 同 时 他 们 发 现 ， 在 实现 开始 的 时 候 所 获得 的 信息 往往 远 远 不 
够 。 他 们 的 和 迭代 周期 是 6 周 ， 而 且 开发 团队 和 业务 分 析 师 身 处 于 不 同 的 
大 洲 ， 这 让 事情 进一步 复杂 化 。 开 发 人 员 从 业务 分 析 师 那里 得 到 的 验 
收 条 件 也 比较 抽象 《例如 ,“ 对 于 这 个 业务 单元 ， 要 确保 所 有 正确 的 产 
品 都 能 够 显示 出 来 。 在 迭代 半途 中 发 现 缺少 某 些 重要 的 东西 ， 会 严 
重 扰乱 产 出 。 某 轮 迭 代 结 束 时 ， 客 户 说 团队 交付 的 东西 完全 不 是 他 们 ] 
所 期 望 的 。 每 个 迭代 的 最 后 一 周 保留 给 Model Office : 实际 上 是 一 个 
迭代 的 演示 会 议 。 有 一 次 ，EFerrero 到 美国 做 Model Office， 并 且 与 业务 
分 析 师 一 起 工作 了 两 天 ， 对 需求 进行 举例 说 明 。 结 果 ， 团 队 在 下 一 个 
迭代 承诺 交付 的 工作 减少 了 20%， 最 终 他 们 成 功 交 付 了 自己 承诺 的 部 
分 。 


注释 : OModel Office 类 似 于 在 开发 阶段 所 做 的 小 型 UAT/ 验 收 测 
试 ， 并 会 召开 演示 会 议 ， 以 便 演示 已 经 完成 的 功能 并 获得 改进 意见 。 


一 一 译 者 注 


“团队 的 情绪 也 好 了 很 多 ，”*”Ferrero 说 道 ，“ 在 此 之 前 ， (开发 人 
A) 在 实现 的 时 候 会 感觉 自己 是 在 瞎 做 ， 必 须 等 待业 务 分 析 师 的 反 
馈 。” 据 Ferrero 所 述 ， 在 他 们 开始 对 需求 做 举例 说 明 后 ， 返 工 量 急剧 下 
年 。 

Ferrero 他 们 并 不 是 唯一 有 此 体会 的 团队 。 几 乎 所 有 本 书 有 所 提 太 
的 团队 都 证 实 了 这 样 一 个 事实 : 对 需求 进行 举例 说 明 的 方法 比 抽象 的 
陈述 说 明 来 得 更 有 效 。 因 为 例子 是 具体 的 、 明 确 的 ， 所 以 它们 是 制定 
精确 需求 的 理想 工具 ， 这 就 是 为 什么 我 们 在 日 常 交 流 中 用 其 来 澄清 意 
思 的 原因 。 

Gerald Weinberg 和 Donald Gause 在 《探索 需求 》 一 书 中 与 道 ， 检 验 
需求 是 否 完整 的 最 好 方法 是 试 着 对 其 设计 黑 盒 测试 。 如 果 我 们 没有 足 
够 多 的 信息 去 设计 出 好 的 测试 用 例 ， 那 么 我 们 也 绝对 没有 足够 多 的 信 
息 来 构建 系统 。 举 例 说 明 需 求 是 一 种 使 用 足够 具体 的 、 可 以 检验 的 信 
息 来 定义 系统 应 该 如 何 工作 的 方法 。 那 些 用 来 说 明 需 求 的 例子 就 是 很 
好 的 黑 盒 测试 。 

根据 我 的 经 验 ， 举 例 说 明 需 求 所 用 的 时 间 要 比 去 实现 它们 少 得 
多 。 比 起 先 试 着 去 实现 软件 ， 然 后 发 现 信息 不 够 用 ， 举 例 说 明 需 求 时 
发 现 信息 不 够 用 所 人 花费 的 时 间 要 少 得 多 。 不 要 去 开发 一 个 不 完整 的 故 
事 ， 这 只 会 让 你 在 迭代 中 才 发 现 问题 ， 我 们 在 协作 制定 需求 说 明 的 过 
程 中 就 可 以 抓 出 此 类 问题 ， 此 时 我 们 还 能 够 解决 这 些 问题 一 -并且 这 
个 时 候 商 业 用 户 还 在 。 

2009 年 5 月 ， 在 Progressive.NET 教 程 中 ， 我 举行 了 一 个 关于 实例 化 
需求 说 明 的 3 小 时 的 工作 坊 。 大 约 有 50 个 人 参加 了 这 个 工作 坊 ， 其 中 
大 部 分 是 软件 开发 人 员 和 测试 人 员 。 我 们 模拟 了 一 种 常见 情况 : 一 位 
客户 要 求 我 们 的 团队 到 他 们 竞争 对 手 的 网 站 去 拷贝 一 些 功能 。 


注释 : OF Whttp://gojko.net/2009/05/12/examples-make-it-easy-to- 
spot-inconsistencies 


我 从 一 个 热门 网 站 拷贝 了 “21 上 点 ?游戏 的 规则 ， 并 要 求 参与 者 使 用 
例子 来 描述 这 些 规 则 。 虽 然 需求 采集 自 一 个 真实 的 网 站 而 且 只 有 区 区 
一 页 ， 但 这 些 需求 模棱两可 、 累 资 刀 余 并 且 残 缺 不 全 。 据 我 的 经 验 ， 
使 用 WOrd 文 档 来 记录 需求 往往 会 引发 这 种 情况 。 

参与 者 分 成 7 个 团队 ， 每 个 团队 只 有 一 个 人 懂 “21 操 ”。 工 作坊 结束 
后 ， 所 有 参与 者 都 一 致 认 为 讨论 实际 的 例子 可 以 帮助 我 们 找 出 不 一 致 
的 地 方 和 功能 分 上 层 。 通 过 反馈 调查 〈 见 下 文 附注 栏 ) ， 我 测算 出 了 共 
识 度 。 昌 然 团 队 中 多 数 人 之 前 从 未 涉足 过 该 领域 ,但 是 7 个 团队 中 有 6 
个 团队 对 困难 的 边缘 情况 给 出 了 相同 的 答案 。 举 例 说 明 需 求 是 交流 领 
域 知识 并 确保 达成 共识 的 非常 有 效 的 方式 。 在 编写 本 书 所 采访 的 众多 
团队 中 ， 我 在 他 们 实际 的 软件 项 目 上 看 到 了 同样 的 效果 。 

反馈 调查 

反馈 调查 是 检验 一 组 人 员 是 否 对 需求 说 明达 成 共识 的 好 方法 。 在 
讨论 过 一 个 故事 之 后 ， 如 果 有 人 对 该 故事 提出 了 一 个 特殊 用 例 ， 工 作 
坊 的 主持 人 必须 请 参与 者 写 下 他 们 认为 系统 应 该 怎样 工作 。 然 后 比较 
全 组 的 回答 。 如 果 所 有 人 的 回答 都 一 致 ， 那 么 每 个 人 对 需求 说 明 的 理 
解 就 没有 出 入 。 如 果 回 答 不 一 致 ， 那 么 一 种 有 效 的 作法 是 按 回答 的 结 
果 分 成 多 个 小 组 ， 每 个 小 组 选 出 一 个 人 来 解释 他 们 的 回答 。 通 过 讨论 
可 以 揭示 误解 的 根源 。 

ea e La ER 但 是 实施 起 来 却 没 那么 容易 。 找 到 
一 组 正确 的 例子 来 说 明 一 个 需求 是 一 个 很 大 的 挑战 。 

本 章 我 会 先 举 一 个 例子 ， 让 大 家 对 使 用 例子 的 过 程 有 一 个 了 解 。 
然后 我 会 对 如 何 确定 一 组 能 正确 说 明 业 务 功能 的 例子 提供 一 些 好 的 意 

见 。 最 后 ， 我 将 谈 及 一 些 举例 说 明 交 叉 功 能 的 方法 以 及 一 些 不 容易 捕 
获 精确 价值 的 概念 


7.1 说 明 : 一 个 


为 了 阐明 如 何 对 一 个 需求 进行 举例 说 明 ， 让 我 们 来 看 看 一 个 关于 
虚构 公司 (ACME 网 店 ) 的 例子 。 这 是 本 书 中 唯一 一 个 虚构 的 公司 ， 为 


了 让 例子 简单 ， 我 必须 虚构 一 个 。ACME 是 一 家 小 型 网 店 ， 它 的 开发 
团队 刚刚 开始 了 一 个 需求 说 明 的 工作 坊 。Barbara 是 一 名 业务 分 析 师 ， 
此 前 一 周 ， 她 与 公司 老板 Owen 一 起 花 了 一 些 时 间 收 集 了 一 些 初 始 的 例 
子 。 她 主持 本 次 工作 坊 ， 并 引入 了 第 一 个 故事 。 

Barbara: 列表 中 的 下 一 项 是 免费 送 货 服 务 。 我 们 已 经 安排 曼 宁 
(Manning) 出 版 社 对 他 们 的 书籍 提供 免费 送 货 服务 。 最 基本 的 例子 
是 : 如 果 用 户 购买 了 一 本 曼 宁 的 书 ， 比 如 说 就 是 你 手中 这 本 ， 购 物 车 
将 提供 免费 送 货 服 务 。 有 问题 吗 ? 

David 是 开发 人 员 ， 他 发 现 了 一 个 潜在 的 功能 分 歧 。 他 问 道 : 是 
免费 送 到 任何 地 方 吗 ? 那 如 果 客 户 住 在 南美 洲 的 一 个 小 岛 上 呢 ? 对 其 
免费 送 货 的 费用 将 远 远 高 于 售 书 所 获得 的 利润 。 

Barbara: 不 ， 不 是 针对 全 世界 ， 只 针对 美国 国内 。 

Tessa 是 测试 人 员 ， 她 问 了 另 一 个 问题 : 在 测试 该 功能 时 ， 首 先 我 
会 检查 我 们 不 对 所 有 图 书 提供 免费 送 货 服 务 。 我 们 可 以 增加 一 个 实例 
来 说 明 免 费 送 货 服务 只 针对 曼 宁 的 图 书 吗 ? 

Barbara: 当然 可 以 。 例 如 ，Agile Testing 是 由 Addison-Wesley 出 
版 社 出 版 的 。 如 果 用 户 买 了 这 本 书 ， 那 么 购物 车 将 不 提供 免费 送 货 服 
务 。 我 觉得 这 比较 简单 ， 没 有 更 多 需要 再 提 的 了 。 谁 可 以 再 另外 想 一 
个 别 的 例子 ? 我 们 能 否 找 出 会 让 这 个 例子 失效 的 数据 ? 

David: 没有 数值 相关 的 边界 条 件 ， 但 是 我 们 可 以 围绕 购物 车 清 
单 展开 。 例 如 ， 如 果 我 同时 购买 了 Agile Testing 和 你 手中 这 本 书 将 会 
怎样 ? 

Barbara: 两 本 书 都 将 免费 送 货 。 只 要 购物 车 中 有 一 本 曼 宁 的 图 
书 ， 你 就 会 得 到 免费 送 货 服务 。 

David: 明白 了 。 但 是 如 果 我 同时 买 了 你 手中 这 本 书 和 一 个 冰 
箱 ， 那 又 将 如 何 呢 ? 送 货 服务 的 成 本 将 比 售 书 的 利润 高 多 了 。 

Barbara: 这 会 是 个 问题 。 我 没 跟 Owen 讨论 到 这 个 问题 。 我 必须 
确认 之 后 才能 回答 你 。 还 有 其 他 问题 吗 ? 

David: 除了 这 个 ， 没 有 别 的 了 。 


Barbara: 好 。 那 除了 冰箱 这 个 问题 ， 我 们 已 经 有 足够 多 的 信息 
可 以 开工 了 吗 ? 

David 和 Tessa: 是 的 。 

Barbara: 很 好 。 下 周 初 我 将 回答 你 的 冰箱 问题 。 


7.2 WAZ 到 位 


好 的 例子 可 以 帮助 我 们 避免 模棱两可 。 要 做 到 这 一 点 ， 必 须 完 全 
没有 误解 。 每 个 例子 都 必须 2 清晰 地 定义 好 上 下 文 以 及 系统 如 何在 一 个 
给 定 的 情况 下 工作 ， 并 且 理 想 情 况 下 这 种 描述 必须 很 容易 进行 校 验 。 

7.2.1 x l; mm 见 “ 是 aS? AA) fo] 


适用 于 : 没有 单独 定义 基本 概念 时 

在 描述 过 程 时 ， 我 采访 的 很 多 团队 使 用 了 “是 / 否 ” 的 党 案 ， 这 使 得 
例子 太 过 简单 化 。 这 会 产生 误导 ， 并 给 大 家 一 个 错 党 “我 们 已 经 达成 共 
识 ”， 而 事实 上 并 不 是 这 样 。 

例如 ，TechTalk 公 司 在 一 个 基于 Web 的 退货 系统 中 ， 描 述 Email 提 
醒 功 能 的 需求 时 碰 到 了 这 个 问题 。 他 们 有 一 些 例子 是 关于 何 时 发 送 
Email 的 ， 但 是 他 们 并 没有 讨论 Email 的 内 容 。 该 系统 的 开发 人 员 
Gaspar Nagy 说 :“ 客 户 期 望 我 们 包含 失败 的 案例 和 人 解决 方法 ， 而 我 们 
并 没有 捕获 到 客户 的 期 望 。 

我 为 一 家 大 型 投资 银行 举行 过 一 个 需求 说 明 工 作坊 。 他 们 的 团队 
在 讨论 款项 支付 如 何 导 向 到 8 不 同 的 系统 。 他 们 把 例子 列 在 表格 里 ， 左 
边 是 条 件 ， 右 边 是 不 同 的 子 系统 ， 根 据 目 标 是 否 接受 事务 来 决定 将 列 
标 成 “是 ”还 是 “ 否 ”。 我 让 他 们 写 下 发 送 到 每 个 系统 的 消息 的 关键 特 
性 ， 而 不 是 “是 ”或 “ 否 ”。 那 时 ， 大 多 数 开 发 人 员 都 误解 了 的 几 个 有 意 
思 的 案例 出 现 了 。 例 如 ， 其 中 一 个 系统 的 事务 更 新 需要 两 条 消息 ， 而 
不 是 一 条 : 一 条 是 取消 原 有 事务 ， 另 一 条 是 注册 一 个 新 的 事务 。 

-提防 例子 中 出 现 “ 是 / 否 ” 的 回答 ， 试 着 将 其 重 写 得 更 加 精确 到 
位 。 


只 要 潜在 的 概念 已 经 单独 描述 过 了 ， 还 是 可 以 在 例子 中 保留 “是 / 
否 ”。 例 如 ， 一 组 例子 可 以 告诉 你 Email 是 否 已 经 发 出 ， 而 另 一 组 例子 
用 来 描述 Email 的 内 容 。 


适用 于 : 当 你 可 以 指定 一 个 具体 的 例子 时 

等 价 类 (比如 “小 于 10”) 或 者 变量 会 让 人 产生 一 种 达成 共识 的 错 
觉 。 不 使 用 具体 的 例子 ， 不 同 的 人 就 可 能 会 有 不 同 的 理解 ， 例 如 小 于 
10 是 否 包含 负 数 。 

当 输 入 参数 使 用 等 价 类 时 ， 期 望 的 输出 必定 被 定义 为 将 输入 值 作 
为 变量 的 公式 。 这 种 方式 实际 上 是 对 功能 描述 的 复制 。 它 没有 提供 具 
体 的 例子 来 验证 ， 也 就 失去 了 举例 说 明 的 价值 。 

为 了 自动 化 ， 这 些 值 的 等 价 类 必须 转译 成 具体 的 某 种 东西 ， 这 意 
味 着 无 论 谁 自动 化 这 些 验证 ， 都 必须 将 需求 说 明 转 译 成 自动 化 代码 。 
这 就 意味 着 出 现 误解 和 曲解 的 概率 增 大 。 


T= 


例子 


据 我 的 经 验 ， 需 求 里 那些 看 起 来 很 直观 的 东西 最 有 可 能 欺骗 我 
们 。 那 些 容易 混淆 的 概念 会 被 讨论 和 探讨 ， 但 是 对 于 那些 似乎 很 明确 
的 概念 (不同 的 人 往往 会 对 它们 有 不 一 样 的 理解 ， 往 往 不 易 察 觉 ， 
会 造成 问题 。 
= 不 要 使 用 等 价 类 ， 要 使 用 有 代表 性 的 具体 的 例子 。 具 体 的 例子 
让 我 们 可 以 无 需 修改 就 直接 自动 化 需求 说 明 的 验证 ， 并 能 确保 所 有 团 


队 成 员 达 成 共识 。 

你 可 以 安全 地 将 等 价 类 用 作 预 期 的 输出 ， 特 别 是 当 你 描述 的 过 程 
具有 不 确定 性 的 时 候 。 例 如 ， 指 明 一 个 操作 的 结果 必须 介 于 0.1 与 0.2 之 
间 ， 这 样 的 陈述 仍然 使 需求 说 明 具 有 可 测试 性 。 如 果 过 程 具有 确定 
性 ， 那 么 一 个 具体 的 数值 可 以 使 其 更 加 精确 ; 即使 对 于 输出 ， 也 可 以 
尝试 使 用 具体 的 数值 。 


~; 


7.3 必须 完 


我 们 必须 有 足够 的 例子 来 描述 某 个 功能 的 完整 范围 。 主 要 业务 用 
例 的 预期 行为 和 简单 的 例子 是 很 好 的 着 手 点 ， 但 一 般 它 们 并 不 是 我 们 
需要 实现 的 功能 的 总 和 。 以 下 的 一 些 想法 有 关于 如 何 对 一 组 初始 的 例 
子 进行 扩展 ， 以 便 对 功能 提供 一 个 全 面 的 了 解 。 


7.3.1 用 数据 作 试 验 


~ 一 旦 你 拥有 了 一 组 你 认为 很 完整 的 例子 ， 那 么 就 应 该 查看 例子 
的 结构 并 试 着 想 出 一 些 会 违反 规则 的 输入 组 舍 。 这 有 助 于 你 发 现 可 能 
漏 掉 的 东西 ， 使 得 需求 说 明 更 健壮 、 更 完整 。 

如 果 例 子 包 含 数 值 ， 你 可 以 试 着 同时 使 用 不 同 边界 条 件 附 近 的 较 
大 数字 和 较 小 数字 。 尝 试 使 用 零 或 负数 。 如 果 例 子 包含 了 多 个 实体 ， 
就 考虑 一 下 是 否 可 以 使 用 多 个 对 象 、 一 个 不 包含 实体 的 例子 是 否 仍然 
有 效 ， 以 及 如 果 同 一 个 实体 定义 了 两 次 又 会 怎么 样 。 

当 协 作 制 定 需求 说 明 时 ， 我 尤其 期 望 测试 人 员 帮 忙 寻找 此 类 例 
子 。 他 们 应 该 会 有 技术 和 进一步 的 试探 方法 来 找 出 潜在 的 有 问题 的 用 
例 。 

你 找 出 的 很 多 技术 上 的 边缘 情况 并 不 会 代表 有 效 的 例子 ， 这 并 疫 
有 什么 问题 。 除 非 你 正在 对 无 效 参数 说 明 错 误 消 息 (这 种 情况 下 ， 这 
些 是 针对 该 业务 功能 的 有 效 例子 ) ， 人 否则 不 要 去 涉及 具体 细节 。 考 虑 
这 些 不 同 的 情况 ， 你 可 能 会 找 出 一 些 不 一 致 的 地 方 ， 以 及 之 前 可 能 还 
没有 考虑 过 的 边缘 情况 。 


用 数据 作 试验 的 一 个 风险 是 输出 将 会 有 太 多 没有 显著 区 别 的 例 
子 。 这 就 是 为 什么 下 一 个 步骤 “提炼 需求 说 明 ”( 详 见 第 8 章 ) 如 此 重要 
的 原因 。 

7.3.2 法 来 检 


适用 于 : 复杂 的 /遗留 的 基础 设施 

在 复杂 的 IT 系统 里 ， 很 容易 忘记 所 有 应 该 发 送信 息 的 地 方 。 

-为 了 测试 某 个 故事 是 否 有 一 组 定义 良好 的 例子 ， 你 可 以 要 求 商 
业 用 户 考虑 一 个 替代 方案 来 验证 最 终 的 实现 。 

“你 还 会 怎么 对 它 进行 测试 ? ”是 开始 这 类 讨论 的 一 个 好 问题 。Bas 
Vodde 还 建议 像 下 面 这 么 问 :“ 还 会 有 其 他 事情 友 生 吗 ? ”在 前 文 7.2.1 节 
里 提 到 的 那个 需求 说 明 工 作坊 中 ， 我 提出 了 这 个 问题 之 后 ， 我 们 发 现 
了 一 个 遗留 的 数据 仓库 ， 有 些 人 认为 它 应 该 接收 事务 ， 而 其 他 人 则 认 
为 它 应 该 忽视 事务 。 这 一 发 现 促使 我 们 进行 了 一 场 讨 论 并 结束 了 这 个 
TH BET I 

Pascal Mestdach 在 IHC 公 司 的 Central Patient Administration BA 
有 类 似 的 经 历 。 他 们 经 常 碰 到 问题 ， 客 户 希 望 在 系统 迁移 期 间 ， 那 些 
新 系统 里 存储 的 数据 会 同时 发 送 到 遗留 系统 ， 但 是 团队 并 不 了 解 这 些 
需求 。 如 果 当 时 要 求 客户 提供 一 种 替代 方法 来 测试 功能 ， 那 他 们 就 可 
以 发 现 客户 期 望 在 遗留 系统 里 同样 能 看 到 这 些 信息 。 

要 求 用 户 使 用 替代 方法 来 检测 功能 ， 也 有 助 于 团队 讨论 出 自动 化 
校 验 的 最 佳 地 点 。 
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最 初 的 测试 替代 测试 方法 
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7.4 WZ 


当 我 们 使 用 例子 来 说 明 功 能 的 时 候 ， 模 棱 两 可 和 前 后 矛盾 的 地 方 
就 会 突显 出 来 ， 因 为 例子 着 重 讨论 真实 的 案例 而 非 抽 象 的 规则 。 为 了 
更 好 地 发 挥 例子 的 功效 ， 例 子 必 须要 真实 。 任 何 编造 的 、 简 化 的 或 者 
抽象 的 例子 都 不 会 有 足够 多 的 细节 ， 也 无 法 展示 足够 多 的 变化 。 要 特 
别 小 心 抽象 实体 ， 比 如 “客户 A”。 找 一 个 真实 的 客户 ， 他 必须 具备 你 
要 描述 的 特点 ， 或 者 你 可 以 关注 到 特点 本 身 而 非 客 户 身上 ， 这 样 会 更 
好 。 


7.4.1 避免 虑 构 自 


=] COBY he 
适用 于 : 数据 驱动 的 项 目 
-在 数据 驱动 的 项 目 中 使 用 真实 的 数据 十 分 重要 ， 因 为 许多 事情 
可 能 会 依赖 于 细微 的 变化 和 不 一 致 的 地 方 。 
来 自 于 Knowledgent Group 的 Mike Vogel 参 与 过 一 个 新 项 目 ， 他 们 
使 用 元 数据 驱动 ETL 来 填充 药物 研究 的 数据 仓库 。 他 们 使 用 了 实例 化 


需求 说 明 ， 但 是 客户 和 团队 双方 都 使 用 虚构 的 例子 来 说 明 功 能 ， 而 没 
有 去 寻找 真实 的 数据 样本 。 他 说 这 种 方式 并 没 能 帮助 他 们 避免 不 一 致 
的 问题 。 

“他 们 (客户 代表 ) 虚构 例子 ， 而 没有 处 理 实 际 的 变化 。 他 们 假定 
自己 可 以 做 某 些 事情 ， 并 把 这 些 事情 排除 在 例子 之 外 。 当 实际 系统 的 
数据 进来 时 ， 总 是 会 碰 到 许多 意外 情况 。>” 

当 项 目 涉 及 遗留 系统 时 ， 这 类 问题 会 更 严重 ， 因 为 遗留 数据 往往 
违背 预期 的 一 致 性 规则 (以 及 一 般 的 逻辑 规则 ) 。 

Jonas Bandi 曾 经 在 TechTalk 公 司 为 学 校 的 数据 管理 重 写 了 一 个 遗 
留 系统 ， 在 理解 了 原 有 的 遗留 数据 结构 和 关系 后 ， 他 发 现 里 面 十 分 复 
杂 。 他 们 期 望 实 例 化 需求 说 明 可 以 保护 他 们 免 受 回 退 ( 详 见 4.5.2 节 )， 
防止 缺陷 ， 但 事与愿违 。 他 们 基于 自己 对 领域 的 理解 虚构 了 例子 。 真 
实 的 遗留 数据 经 常 有 令 人 意 想不到 的 意外 情况 。Bandi 说 : 

“即使 在 所 有 场景 (测试 结果 ) 都 是 绿色 的 (测试 通过 ) 并 且 一 切 
都 看 起 来 很 好 的 情况 下 ， 我 们 仍然 还 有 很 多 缺陷 ， 这 是 由 来 自 于 遗留 
系统 的 数据 所 产生 的 。” 

为 了 减少 遗留 数据 在 迭代 后 期 给 团队 带 来 的 意外 风险 ， 请 尝试 在 
例子 中 使 用 来 自 于 现 有 遗留 系统 的 真实 数据 ， 而 非 使 用 全 新 的 用 例 。 

使 用 现 有 的 数据 可 能 需要 对 一 些 敏 感 数 据 自动 做 模糊 处 理 ， 这 会 
对 目 动 化 数据 的 管理 策略 市 来 影响 。 对 于 此 类 问题 有 一 些 好 的 解决 办 
法 ， 详 见 9.5 节 。 

7.4.2 得 


适用 于 : 与 企业 用 户 一 起 工作 时 

对 于 卖 企业 软件 给 多 个 客户 的 团队 而 言 ， 他 们 很 少 会 有 客户 代表 
参与 到 协作 制定 需求 说 明 的 工作 坊 中 ， 因 为 这 是 一 种 奢求 。 产 品 经 理 
会 从 不 同 的 客户 那里 收集 需求 ， 并 决定 发 布 计 划 。 这 会 导致 收 义 和 误 
解 的 可 能 性 。 我 们 可 能 会 有 非常 精确 和 清楚 的 例子 ， 但 它们 可 能 并 没 
有 捕获 客户 所 需要 的 。 


发 还 者 | 主题 | 数据 
ZPL ”我 的 例子 | 
客 尸 2 ”我 的 例子 
客户 3 ”我 的 例子 


-要 确保 用 来 说 明 需 求 的 例子 是 真实 的 。 真 实 的 例子 包含 来 自 客 
户 的 数据 。 

当 我 们 与 外 部 的 项 目 干 系 人 一 起 工作 时 ， 我 们 同样 可 以 应 用 那些 
团队 内 部 用 来 确保 共识 的 窍门 。Andrk Brissette 把 客户 的 电子 邮件 当 作 
入 手 点 ， 用 它 来 展开 Talia 系 统 自 动 对 话 的 讨论 : 

“他 们 应 该 写 一 封 这 样 的 电子 邮件 : “如 果 这 个 问题 我 可 以 问 
Talia， 那 将 会 更 简单 ， 她 会 告诉 我 ..….， 然 后 我 就 能 够 去 做 ..…….。 :在 
这 个 案例 中 ， 用 户 提供 了 对 话 的 第 一 个 草案 。” 

Brissette 记 录 下 此 类 电子 邮件 ， 并 把 它们 作为 初始 的 例子 来 描述 所 
需 的 功能 。 这 可 以 确保 外 部 项 目 干系 人 的 请 求 得 到 满足 。 请 看 图 7-1， 
它 是 由 此 产生 的 需求 说 明 的 例子 。 请 注意 ， 理 想 情 况 下 这 个 例子 需要 
进一步 提炼 。 详 见 8.3.2 节 。 

在 RainStor，Adam Knight 的 团队 使 用 这 种 方法 开发 了 一 个 结构 化 
数据 的 归档 系统 。 他 们 与 客户 一 起 获取 真实 的 数据 集 和 典型 查询 所 预 
期 的 目标 。 当 客户 不 能 提供 一 个 具体 的 用 例 时 ， 他 们 会 追问 例子 ， 有 
时 候 会 安排 与 客户 一 起 进行 工作 坊 。 有 个 常见 的 例子 是 关于 客户 不 能 
提供 具体 用 例 的 : 一 个 还 没有 买 家 的 经 销 商 想 要 系统 支持 某 些 功能 ， 


因为 他 们 猜想 这 样 会 更 容易 销售 。 其 中 一 个 例子 是 他 们 要 求 电子 邮件 
归档 系统 提供 镜像 功能 。 Knight 说 : 

“他 们 看 到 了 一 个 电子 邮件 归档 系统 ， 然 后 说 我 们 的 系统 要 能 够 以 
同样 的 方式 进行 工作 。 电 子 邮 件 归 档 系统 有 上 千 封 邮件 ， 但 是 在 我 们 
的 系统 里 会 有 几 十 亿 的 记录 。 你 想 要 同 级 别 的 粒度 吗 ? 日 志 要 怎么 
办 ? 这 是 一 种 最 难处 理 的 需求 。 一 般 来 讲 ， 我 们 会 设法 追问 客户 要 一 
些 例子 。 我 们 会 安排 一 些 演示 来 做 功能 原型 并 从 头 检 查 一 遍 。” 


Tableau de bord ，P_ Talia > > Specifications Executables (Talia) > new dialogs Parcourir » André Brissette v 


> | can ask talia for the list of possible actmities anytime 
| can ask talia for the list of possible @ Modifier 5p Ajouter ~ $ Outils ~ 


activities anytime 


Fa 


Ajouté par André Srissette, modifié par André Brissettele May 10, 2010 (afficher les modifications) 


Green V| - CONFIGURE SET AS IMPLEMENTED 
Source Requirements: (None) - EDIT 
_ Execute >) ; [ TaliaUnderDevelopment EDIT] 


I can ask for possible activities when she ask me if | want to specify time for today 
Talia Do you want to specify time for today? 
André what are possible activities? 
Talia Your possible activities for this specific day are 
Talia > Pyxis - Talia - Développement 
Talia > Pyxis -_grown - Marketing 
Talia > Pyxis - Formation ScrumMaster Montréal 
Talia Wich one you want to specify time for? 
Andre developement 
Talia How long did you spend on Pyxis - Talia - Développement? 
André 7.5 
Talia Do you want to specify time for anything else? 
André No 
Talia Thank you 


图 7-1 一 个 客户 对 话 的 例子 ， 用 作 Talia 系 统 的 一 个 需求 说 明 


为 了 避免 产品 经 理 对 客户 需求 的 理解 和 客户 真正 的 需求 之 间 存 在 
模糊 和 误解 ， 请 坚持 使 用 例子 来 与 客户 沟通 。 可 以 在 需求 说 明 工作 坊 


上 利用 这 些 例子 展开 讨论 。 这 些 例子 还 必须 包含 在 最 终 的 可 执行 需求 
说 明 里 ， 以 便 确 保 客 户 的 期 望 得 到 满足 。 


7.5 DA 理 


刚 开 始 使 用 实例 化 需求 说 明 的 时 候 ， 团 队 常 犯 的 一 个 错误 是 使 用 
错综复杂 的 例子 来 描述 需求 。 他 们 专注 于 捕获 真实 例子 的 细 术 末节 , 
并 创建 庞大 的 、 另 人 费解 的 表格 ， 有 几 十 多 列 和 行 。 这 样 的 例子 会 增 
加 评估 需求 说 明 一 致 性 和 完整 性 的 难度 。 

我 更 喜欢 把 例子 当成 需求 ， 不 喜欢 抽象 的 描述 ， 一 个 主要 的 原因 
是 它们 可 以 让 我 考虑 到 功能 分 歧 和 不 一 致 性 的 问题 。 事 情 一 旦 精确 ， 
就 更 容易 发 现 缺失 的 情况 。 这 要 求 对 一 个 特定 功能 的 整 组 例子 都 有 所 
了 解 。 如 果 例 子 不 易 理 解 ， 我 们 将 无 法 评估 它们 的 完整 性 和 一 致 性 。 
下 面 是 一 些 既 能 避免 此 类 问题 ， 同 时 依然 能 够 保持 例子 精确 性 和 真实 
性 的 想法 。 

7.5.1 3 iz 6 组 合 


当 团 队 开始 使 用 实例 描述 需求 时 ， 测 试 人 员 通 常会 误解 该 过 程 的 
目的 ， 并 且 坚 持 覆 盖 参 数 的 所 有 可 能 组 合 。 通 过 实例 说 明 现 有 的 所 有 
情况 并 没有 多 大 意义 ， 也 不 会 增进 理解 。 

-~ 当 举 例 说 明 需 求 时 ， 寻 找 那些 可 以 推进 讨论 并 增进 理解 的 例 
子 。 

我 强力 反对 不 经 讨论 就 丢弃 任何 作为 边界 情况 提出 的 例子 。 如 果 
有 人 提出 了 一 个 边界 条 件 的 例子 ， 而 别人 认为 这 种 情况 已 经 覆盖 到 
了 ， 那 么 可 能 有 两 种 原因 : 要 么 提出 这 种 例子 的 人 不 理解 现存 的 例 
子 ， 要 么 他 们 真 的 发 现 了 一 些 别人 没有 发 现 的、 会 破坏 现 有 描述 的 东 
西 。 这 两 种 情况 都 值得 我 们 对 这 个 例子 进行 讨论 ， 以 确保 房间 里 的 每 
个 人 都 对 这 个 作为 边界 情况 提出 的 例子 有 相同 的 理解 。 


7.9.2 7 


如 果 用 来 描述 某 个 功能 的 例子 太 多 了 ， 或 者 所 用 的 例子 很 复杂 ， 
往往 意味 着 这 些 例子 应 该 用 更 高 层次 的 抽象 来 描述 。 

~ 应 该 仔细 查看 这 些 例子 ， 并 且 试 着 找 出 缺失 和 隐 含 的 概念 。 将 
这 些 概念 显 式 化 ， 并 单独 对 它们 进行 定义 。 重 整 这 类 例子 会 使 需求 说 
明 更 易 理 解 ， 并 融 来 更 好 的 软件 设计 。 

领域 驱动 设计 的 一 个 核心 思想 是 找 出 缺失 和 隐 含 的 概念 ， 并 在 
系统 设计 中 将 其 显 式 化 。 


注释 : 出 自 Eric Evans 所 著 的 Domain-Driven Design:Tackling 
Complexity in the Heart of Software— 书 (Boston, AddiSon-Wesley 
Professional，2003)， 中 译本 《领域 驱动 设计 : 软件 核心 复杂 性 应 对 之 
道 》。 


我 曾经 协助 过 一 个 团队 举行 了 一 个 工作 坊 ， 当 时 他 们 正在 重 写 一 
个 财务 子 系统 ， 并 逐步 将 交易 从 遗留 系统 迁移 到 新 系统 上 。 这 个 工作 
坊 专 注 的 需求 是 要 将 荷兰 的 交易 迁移 到 新 系统 上 。 起 初 我 们 在 一 块 白 
板 上 写 下 例子 ， 但 很 快 就 找 不 到 空白 的 地 方 了 。 仔 细 审 视 这 些 例子 
后 ， 我 们 发 现 痢 述 的 事情 无 非 有 3 件 : 如 何 判定 哪些 交易 是 荷兰 的 ， 如 
何 判定 哪些 交易 已 经 迁移 了 ， 以 及 交易 迁移 之 后 会 有 什么 变化 。 

因为 我 们 同时 阐述 这 几 件 事情 ， 所 以 我 们 需要 处 理 相关 情况 的 众 
多 组 合 。 尝 试 总 结 这 些 例子 的 时 候 ， 我 们 发 现 了 两 个 隐 含 的 概念 : 交 
易 地 和 迁移 状态 。 之 后 我 们 将 这 个 需求 分 成 3 个 部 分 ， 并 且 每 一 部 分 都 
使 用 一 组 单独 的 、 集 中 的 例子 进行 描述 。 我 们 有 一 个 需求 说 明 是 关于 
如 何 判 断 一 个 交易 是 否 是 在 荷兰 进行 的 如何 计算 交易 地 点 ) 。 另 外 
有 一 组 专门 的 例子 描述 了 交易 地 点 对 迁移 状态 产生 的 影响 。 在 这 组 例 
子 中 ， 我 们 只 用 了 一 次 “荷兰 ”， 而 无 须 遍 历 所 有 构成 荷兰 交易 的 情 
况 。 第 三 组 例子 描述 了 在 处 理 迁 移 和 未 迁移 交易 时 的 区 别 。 


这 样 分 割 需求 说 明 可 以 帮助 团队 显著 改善 系统 的 设计 一 一 因为 3 组 
不 同 的 例子 清晰 地 指出 了 模块 化 的 概念 。 下 次 他 们 再 有 迁移 一 组 交易 
的 需求 时 ， 只 要 修改 迁移 交易 的 定义 就 可 以 了 。 交 易 在 迁移 之 后 保持 
不 变 的 话 又 会 怎样 呢 ? 同样 地 ， 判 定 交 易 地 点 的 方法 没有 变化 。 

分 离 这 些 概念 还 有 助 于 我 们 对 交易 地 点 展开 更 加 有 意义 的 讨论 ， 
因为 我 们 应 对 的 是 一 组 较 小 而 且 集 中 的 例子 。 我 们 发 现 ， 有 些 人 认为 
股票 发 生 交 易 的 公司 的 注册 地 会 决定 交易 地 点 ， 而 其 他 人 则 认为 这 只 
与 公司 在 哪里 进行 股票 交易 有 关 。 

寻找 缺失 的 概念 和 提高 抽象 的 层次 与 日 常 交流 中 所 发 生 的 事情 并 
没有 区 别 。 比 如 试 着 不 用 “车 ”这 个 字 ， 给 出 一 句 诸如 “如 果 开 车 来 ， 请 
事先 订 好 停车 位 ”的 指示 语 。 你 要 注重 它 的 属性 。 汽 车 可 以 描述 成 是 一 
辆 融 有 4 个 轮子 、4 局 门 、4 个 座位 以 及 一 个 沫 油 发 动机 的 交通 工具 。 但 
是 我 们 还 有 双开 门 的 车 ， 有 其 他 类 型 的 发 动机 和 不 同 数量 的 座位 等 。 
列 出 所 有 这 些 例子 会 使 得 说 明 变 得 极端 复杂 ; 反之 ， 我 们 会 创建 一 个 
更 高 层次 的 概念 来 改善 沟通 。 汽 车 是 如 何 制 造 的 与 停车 指示 没有 任何 
关系， 重要 的 是 到 达 的 人 是 否 开 车 来 。 


无 论 何 时 看 到 一 个 需求 说 明 里 有 太 多 或 太 复杂 的 例子 ， 你 可 以 试 
着 提高 这 些 描述 的 抽象 层次 ， 然 后 另行 说 明基 本 概念 。 

通过 使 用 精确 真实 的 例子 来 描述 需求 ， 同 时 对 其 进行 重新 组 织 以 
易于 理解 ， 我 们 束 能 捕获 所 8 需 功 能 的 根本 所 在 。 我 们 也 要 确保 需求 摘 
述 得 足够 详细 ， 以 便 开发 人 员 和 测试 人 员 有 足够 多 的 信息 去 开始 工 
作 。 这 些 例 子 可 以 在 交付 过 程 中 代替 抽象 的 需求 ， 并 充当 需求 说 明 、 
开发 目标 以 及 验收 测试 的 检验 条 件 。 


7.6 > 


举例 说 明 单 独 的 功能 需求 比较 直观 ， 但 是 很 多 团队 在 那些 交叉 的 
或 者 难以 使 用 不 连续 的 问 丛 11 来 朱 述 的 功能 里 将 否 挣扎 。 在 我 参与 的 
大 部 分 实例 化 需求 说 明 工 作坊 里 ， 通 常 至 少 有 一 个 人 会 说 对 于 “功能 
性 ”需求 这 是 没有 问题 的 ， 但 是 对 于 “ 非 功能 ”需求 而 言 则 行 不 通 ， 因 为 
后 者 没有 那么 精确 。 

什么 是 非 功能 性 需求 

如 性 能 、 易 用 性 或 者 反应 时 间 这 类 特性 ， 往 往 称 为 非 功 能 性 的 ， 
因为 它们 与 单独 的 功能 没有 关系 。 通 常 来 讲 ， 我 反对 将 需求 按 功 能 
性 、 非 功能 性 来 分 类 ， 但 是 这 不 是 本 书 要 讨论 的 话题 。 很 多 通常 称 为 
非 功能 性 的 特性 却 隐 含 着 功能 性 。 例 如 ， 性 能 需求 可 能 暗含 着 缓存 功 
能 、 持 久 化 约束 等 。 据 我 的 经 验 ， 人 们 最 可 能 将 功能 性 需求 当 作 非 功 
能 性 需求 的 是 那些 交叉 的 需求 (例如 安全 性 ) ， 或 者 是 那些 非 离散 的 
却 可 以 按照 比例 来 衡量 的 需求 (例如 性 能 ) o Dan North (在 与 我 私 
下 交流 时 ) 指出 ， 那 些 列 为 非 功 能 性 的 需求 通常 说 明 团队 还 未 明确 地 
找到 该 功能 的 项 目 干 系 人 。 

到 目前 为 止 ， 我 还 没有 看 到 过 一 个 非 功能 性 需求 无 法 使 用 例子 来 
说 明 的 情况 。 即 使 是 可 用 性 (这 可 能 是 软件 开发 中 最 模糊 不 清和 最 主 
观 的 概念 ) ， 都 可 以 用 例子 来 说 明 。 请 可 用 性 专家 给 你 看 她 喜欢 的 网 
站 ， 这 就 是 一 个 好 的 、 实 际 的 例子 。 这 类 例子 的 验证 可 能 无 法 自动 


化 ， 但 是 例子 是 实际 的 和 精确 的 ， 足 够 引发 一 场 很 好 的 讨论 。 下 面 是 
一 些 很 好 的 意见 ， 可 以 帮助 你 捕获 带 实例 的 非 功 能 性 需求 。 


适用 于 : 当 性 能 是 一 个 关键 特性 时 

因为 性 能 测试 往往 需要 一 个 独立 的 环境 以 及 与 生产 环境 相 类 似 的 
硬件 ， 在 很 多 性 能 非常 关键 的 系统 中 开发 人 员 无 法 在 它们 的 硬件 上 运 
行 任何 相关 的 测试 。 这 并 不 意味 着 团队 可 以 不 去 讨论 性 能 需求 。 

~ 清晰 地 指定 性 能 条 件 和 举例 说 明 可 以 帮助 我 们 建立 共识 ， 并 可 
以 给 开发 团队 提供 清楚 的 目标 实现 。 

在 RainStor， 性 能 对 于 它们 的 数据 归档 工具 十 分 关键 ， 所 以 他 们 
会 确保 性 能 需求 表达 详 备 。 他 们 的 性 能 需求 是 以 下 面 这 种 格式 收集 
的 :“ 系 统 在 Z 个 CPU 上 必须 在 Y 分 钟 乙 内 导入 X 条 记录 ”。 开 发 人 员 要 
么 可 以 使 用 专门 的 测试 硬件 ， 要 么 让 测试 人 员 帮 助 他 们 运行 测试 并 提 
供 反 馈 。 

~ 请 记 住 , “要 比 现 有 系统 快 ” 不 是 一 个 好 的 性 能 需求 。 要 告诉 人 
们 具体 需要 多 快 以 及 用 的 是 何 种 方式 。 


7.6.2 AJUI y 


用 户 界 面 的 布局 和 易 用 性 无 法 简单 地 使 用 刚好 放 入 真 值 表 或 自动 
化 测试 的 例子 来 制定 。 不 过 这 并 不 意味 着 我 们 不 能 讨论 有 关 的 例子 。 

我 通常 会 创建 一 些 纸 质 的 原型 ， 我 会 把 用 户 界 面 元 素 的 图 样 以 及 
打印 下 来 的 网 站 粘贴 在 一 起 。 仔 细 讨 论 一 两 个 例子 ， 这 种 方法 可 以 很 
好 地 确保 屏幕 上 包含 了 客户 需要 的 所 有 信息 。 

商业 客户 通常 觉得 没有 用 户 界面 很 难 考虑 问题 ， 因 为 他 们 就 是 用 
界面 进行 工作 的 。 这 就 是 为 什么 当 客 户 在 屏幕 上 看 到 软件 的 时 候 经 党 
会 有 “ 回 退 ”发 生 的 原因 。 

~ 有 时 候 我 们 不 用 讨论 后 台 的 处 理 过 程 ， 借 助 于 用 户 界面 的 样 例 
就 可 以 预先 获得 更 加 具体 的 信息 。 

有 几 个 我 采访 过 的 团队 在 使 用 Balsamiq Mockups? ， 它 是 一 个 提 
供 低 精度 用 户 界 面 原 型 的 网 页 /桌面 程序 。 我 发 现 纸 质 原型 更 容易 使 
用 ， 因 为 我 们 可 以 使 用 勇 切 下 来 的 图 案 也 可 以 编写 备 注 ， 但 是 如 果 你 
想 要 共享 工作 内 容 ， 软 件 系统 会 更 适合 。 


注释 : CDwww.balsamiq.com/products/mockups 


RainStor 的 Adam Knight 对 这 种 方式 做 了 更 进一步 的 发 展 ， 他 创建 
了 交互 式 原型 来 与 客户 探索 模糊 的 需求 。 他 说 : 

“我 们 没有 使 用 纸 质 原型 ， 而 是 使 用 shell 脚 本 将 几 个 例子 做 成 命令 
行 界面 的 原型 ， 然 后 与 客户 一 起 审查 这 些 例子 ， 请 他 们 详细 描述 他 们 
想 要 如 何在 系统 里 使 用 新 的 功能 。>” 

对 于 这 种 交互 式 工作 坊 提 供 的 功能 性 实例 ， 开 发 团队 以 后 可 以 用 
来 对 需求 进行 说 明 。 团 队 也 可 以 使 用 这 种 方法 来 确定 范围 (详情 请 参 
阅 5.2.3 节 ) 。 


7.6.3 试用 QUPER 模 型 
适用 于 : 按 比例 缩放 的 需求 


当 需 求 产 生 的 不 是 离散 的 、 精 确 的 结果 时 ， 我 们 就 很 难 去 讨论 它 
们 。 为 什么 网 页 需要 在 两 秒 钟 之 内 呈现 完毕 ， 而 不 是 三 秒 钟 或 一 秒 
钟 ， 你 还 记得 最 后 一 次 对 这 个 问题 进行 有 意义 的 讨论 是 什么 时 候 吗 ? 
多 数 情 况 下 ， 我 们 会 不 经 讨论 或 理解 就 接受 此 类 需求 。 

在 2009 年 的 Oresund 开 友 者 大 会 上 ，Bjorn Regnell] 做 了 一 场 天 于 
QUPER® 的 演讲 ， 这 是 一 个 有 意思 的 模型 ， 用 于 说 明 那 些 非 离散 的 、 
却 可 以 按 比例 缩放 的 需求 (例如 ， 启 动 时 间或 者 响应 时 间 ) 。 我 还 未 
在 项 目 中 尝试 过 这 个 模型 ， 但 是 它 十 分 有 趣 、 耐 人 寻味 ， 因 此 我 决定 
将 其 宫 括 在 本 书 中 。 


注释 : (请 参考 http://oredev.org/videos/supporting-roadmapping-of- 
quality-requirements 以 及 IEEE Software journal, Mar/Apr2008 


QUPER 使 用 成 本 、 价 值 和 质量 的 坐标 轴 来 可 视 化 按 比 例 缩放 的 需 
求 。 该 模型 的 思想 是 对 可 以 按 比 例 缩放 的 需求 进行 成 本 效益 断 点 和 障 
碍 的 评估 ， 使 大 家 可 以 去 讨论 这 种 需求 。 

QUPER 模 型 假定 这 类 需求 会 在 S 曲 线 上 产生 效益 ， 而 且 曲 线 上 有 3 
个 重要 的 点 (MAMA) 。 可 用 性 是 产品 从 不 可 用 转向 可 用 的 点 。 例 
如 ， 手 机 局 动 时 间 的 可 用 性 点 是 一 分 钟 。 分 化 描述 的 是 当 某 个 功能 发 
展 出 会 影响 市 场 的 具有 竞争 力 的 优势 的 时 候 。 例 如 ， 手 机 启动 时 间 的 
分 化 点 是 5 秒 钟 。 饱 和 是 指 质量 提升 变 得 矫 枉 过 正 时 。 手 机 启动 需要 半 
秒 或 者 一 秒 对 用 户 来 说 没有 区 别 ， 那 么 一 秒 钟 就 是 手机 局 动 的 一 个 可 
能 的 饱和 点 。Regnell 措 出 超过 饱和 点 就 意味 着 我 们 在 错误 的 地 方 进行 
了 投资 。 

该 模型 的 另 一 个 假设 是 质量 的 提升 并 没有 导致 成 本 的 线性 增加 。 
在 某 些 点 上 成 本 会 陡然 增加 。 此 时 产品 可 能 必须 使 用 其 他 技术 重 写 ， 
或 者 会 对 架构 产生 显著 的 影响 。 这 些 点 就 称 为 该 模型 的 成 本 障碍 。 

= 为 可 以 按 比例 缩放 的 需求 定义 障碍 点 和 断 点 ， 可 以 让 我 们 就 产 
品 适合 市 场 中 的 什么 位 置 以 及 我 们 的 市 场 定位 是 什么 做 出 更 有 意义 的 
讨论 。 


我 们 可 以 使 用 断 点 和 障碍 点 为 项 目的 不 同 阶段 定义 相应 的 目标 ， 
并 且 让 按 比例 缩放 的 需求 变 得 可 以 衡量 。Regnell 建 议 将 此 类 需求 设 定 
成 一 个 一 个 区 间 而 非 离散 的 点 ， 因 为 持续 的 质量 需求 可 以 使 其 产生 更 
好 的 效果 。 例 如 ， 如 果 你 只 是 想 让 软件 具备 竞争 软件 的 相同 功能 ， 那 
么 其 目标 束 非 常 接近 可 用 性 点 ， 肯 定 不 会 超过 分 化 足 。 为 了 让 产品 具 
有 独特 的 卖 息 ， 其 目标 应 该 介 于 分 化 点 和 饱和 点 之 间 。 在 同一 条 曲线 
上 将 成 本 障碍 可 视 化 ， 将 有 助 于 项 目 干系 人 理解 在 不 必 进 行 超 预期 投 
资 的 情况 下 ， 他 们 可 以 将 目标 推行 多 远 。 

7.6.4 WCR 查 清 


适用 于 : 交叉 的 关注 点 

通常 ， 当 客户 强行 增加 一 个 全 局 性 的 通用 需求 时 ， 他 们 会 觉得 更 
安全 。 我 参加 过 很 多 对 性 能 有 全 面 要 求 的 项 目 ， 例 如 ,， “所 有 页 面 要 在 
一 秒 种 内 加 载 完成 。” 多 数 情况 下 ， 实 现 这 样 的 需求 〈 以 及 其 他 类 似 的 
全 局 性 需求 ) 是 浪费 金钱 。 通 常 来 说 ， 只 有 首页 和 一 些 关 键 功能 必须 
在 一 秒 种 内 加 载 完成 ， 其 他 很 多 页 面 可 以 加 载 得 较 慢 。 用 QUPER 模 型 
的 语言 来 说 ， 只 有 少数 关键 页 面 的 加 载 时 间 需 要 接近 于 分 化 点 ， 其 他 
页 面 的 加 载 时 间 可 能 更 接近 于 可 用 性 点 。 

问题 是 这 类 需求 往往 是 在 项 目 开始 时 定义 的 ， 而 此 时 我 们 还 不 知 
道 产品 看 起 来 会 是 什么 样 的 。 

Christian Hassa 建 议 不 要 按照 表面 价值 来 采用 这 样 的 需求 ， 而 是 要 
将 这 些 交 叉 的 需求 作为 讨论 的 核查 清单 。 他 说 : 

“全 局 性 地 指明 整个 系统 ‘必须 在 10 毫 秒 内 响应 ;很 容易 ， 但 是 并 不 
是 每 一 个 功能 都 需要 这 种 级 别 的 响应 时 间 。 到 底 系 统 需要 在 10 富 秒 内 
做 什么 ? 需要 发 送 一 封 电子 邮件 、 记 录 动 作 ， 还 是 做 出 回应 呢 ? Ri 
要 在 心里 为 每 个 功能 都 创建 此 类 非 功能 性 条 件 的 验收 标准 。” 

-在 评审 一 个 故事 的 时 候 ， 为 讨论 准备 一 份 核查 清单 可 以 确保 你 
将 所 有 重要 问题 都 纳入 了 考虑 的 范围 。 你 可 以 用 它 来 判定 哪个 交叉 关 
注 点 适用 于 某 个 特定 的 故事 ， 而 后 你 就 可 以 重点 描述 这 些 方面 了 。 


7.6.5 建立 一 个 参 


适用 于 : 需求 无 法 量化 的 时 候 

由 于 可 用 性 比较 主观 并 且 依 赖 于 多 种 因素 ， 所 以 很 难 将 其 量化 。 
但 这 并 不 意味 着 无 法 使 用 例子 对 它 进 行 详细 说 明 。 事 实 上 ， 也 只 能 用 
这 种 方法 来 详细 说 明 。 

实用 性 和 其 他 类 似 的 无 法 量化 的 功能 ， 如 可 玩 性 和 趣味 性 ， 对 视 
频 洲 戏 来 说 很 天 键 。 这 些 特 性 无 法 简单 地 使 用 传统 的 用 来 换 述 需求 的 
文档 进行 详细 说 明 。 Supermassive Games 是 一 家 位 于 英国 的 视频 游戏 
工作 室 ， 他 们 在 游戏 开发 中 应 用 了 敏捷 过 程 。 他 们 的 团队 使 用 核查 清 
单 来 确保 特性 的 不 同方 面 都 被 完全 履 盖 ， 但 是 这 样 还 是 不 足以 处 理 那 
些 功能 的 不 确定 性 和 主观 性 。 

Harvey Wheaton 是 Supermassive 工 作 室 的 总 监 ， 他 在 SPA2010 会 议 
© 上 的 演讲 里 说 这 些 功 能 具有 “难以 捉摸 的 特性 "。 据 Wheaton 所 述 ， 他 
们 通常 会 在 早期 致力 于 将 某 个 功能 完成 到 最 终 的 质量 水 平 ; 然后 ， 团 
队 可 以 将 其 当 作 “ 完 成 ”的 一 个 例子 : 


注释 : (Dhttp://gojko.net/2010/05/19/agile-in-a-start-up-games- 
development-studio 


“我 们 在 过 程 中 尽早 构建 一 个 所 谓 的 :垂直 切片 '， 通 常 是 在 试 生 产 
阶段 的 末期 。 这 个 垂直 切片 是 游戏 的 一 个 小 片段 (例如 ， 一 个 关卡 、 
关卡 的 一 部 分 或 游戏 介绍 部 分 ) ， 并 且 达 到 最 终 的 〈 可 交付 的 ) 质 
量 。 通 常 有 一 个 “水 平 切 片 ? 对 其 进行 补充 ， 也 就 是 说 ， 整 个 游戏 
的 “ 宽 ' 切 片 ， 只 是 概略 的 并 且 低 保 真 度 的 ， 目 的 是 对 游戏 的 规模 和 广 
度 给 出 一 个 概念 。 

你 可 以 大 量 使 用 参照 的 例子 或 概念 图 来 描述 最 终 产品 的 视觉 外 观 
和 精确 度 ， 并 为 此 聘请 专门 的 人 员 制 作出 展示 游戏 外 观 的 高 质量 图 
稿 。 

Supermassive Games 并 没有 尝试 量化 那些 具有 不 可 捉摸 特性 的 功 
能 ， 他 们 会 建立 一 个 参照 的 例子 ， 这 样 团队 成 员 融 可 以 据 此 比较 他 们 


的 工作 。 

~ 举例 说 明 不 可 量化 的 功能 ， 行 之 有 效 的 一 种 方式 是 建立 一 个 参 
照 的 例子 。 

总 而 言 之 ， 不 要 使 用 * 非 功能 性 需求 ”的 分 类 来 避免 艰难 的 对 话 ， 
要 确保 团队 对 商业 用 户 对 系统 的 预期 《包括 交叉 的 关注 点 ) 达成 一 个 
共识 。 即 使 最 终 的 例子 以 后 不 易 进行 目 动 化 ， 我 们 还 是 有 必要 进行 前 
期 讨论 ， 并 使 用 例子 来 明确 化 和 精确 化 用 户 的 预期 ， 这 样 可 以 确保 交 
付 团队 专注 于 构建 正确 的 产品 。 


7.7 铭记 


始终 使 用 同一 组 例子 贯穿 需求 说 明 、 开 发 以 及 测试 阶段 ， 以 确保 
全 体 人 员 对 需要 交付 的 内 容 有 同样 的 理解 。 

用 于 说 明 功 能 的 例子 必须 精确 、 完 整 、 真实 以 及 容易 理解 。 

比 起 在 实施 阶段 才 发 现 问题 ， 真 实 的 例子 有 助 于 更 快 地 发 现 不 一 
致 的 地 方 和 功能 分 歧 。 

有 了 一 组 初始 的 例子 后 ， 就 可 以 立即 使 用 数据 进行 试验 ， 同 时 可 
以 寻找 替代 方法 来 测试 一 个 功能 ， 以 便 完成 需求 说 明 。 

当 例 子 很 复杂 并 且 例 子 太 多 或 者 出 现 太 多 因素 时 ， 你 束 要 寻找 缺 
失 的 概念 并 尝试 使 用 更 高 层次 的 抽象 来 解释 例子 。 使 用 一 组 集中 的 例 
子 来 单独 说 明 新 的 概念 。 


8 章 提炼 需求 i 


“ 原 钻 是 无 光泽 的 、 半 透明 的 晶体 ， 类 似 于 玻璃 碎片 。 为 了 加 工 成 
首饰 ， 必 须 把 它 切割 成 特定 的 宝石 形状 ， 然 后 一 面 一 面 地 进行 抛光 。” 


— Edward Jay Epstein, The Diamond Invention® 


注释 : Dhttp://www.edwardjayepstein.com/diamond/chap11.htm 


协作 讨论 是 一 种 非常 好 的 建立 共识 的 方法 ， 但 是 它 只 能 推动 最 简 
单 的 项 目 ， 如 果 要 推动 其 他 项 目 就 无 能 为 力 了 。 除 非 团 队 规 模 非常 小 
并 且 项 目 周期 也 很 短 ， 可 以 依赖 于 人 们 的 短期 记忆 ， 否 则 我 们 必须 以 
其 他 某 种 方式 来 记录 这 些 知 识 。 

对 关键 实例 进行 讨论 之 后 ， 对 白板 上 进行 拍照 是 获取 这 些 知识 的 
最 简单 方式 。 但 此 时 的 例子 还 很 原始 ， 原 始 的 例子 就 像 未 经 切割 的 钻 
石 一 一 非常 有 价值 ， 但 远 未 成 型 。 从 岩石 中 分 离 出 真正 的 钻石 ， 对 它 
们 进行 抛光 ， 并 分 割 成 易于 销售 的 尺寸 ， 这 样 才能 显著 提升 它们 的 价 
值 。 对 用 于 描述 需求 的 关键 实例 来 说 ， 也 是 同样 的 道理 。 这 些 实例 是 
非常 好 的 着 手 点 ， 但 是 为 了 使 其 价值 最 大 化 ， 我 们 必须 对 它们 进行 提 
炼 和 润色 ， 以 便 清 晰 地 说 明 重 点 ， 并 创建 出 使 团队 在 眼下 和 未 来 都 可 
以 使 用 的 需求 说 明 。 

实施 实例 化 需求 说 明之 所 以 失败 ， 一 个 最 常见 的 原因 是 没有 伦 时 
间 去 加 工 原始 的 例子 。 讨 论 需 求 说 明 往 往 需 要 做 一 些 实验 。 我 们 会 发 
现 新 的 见解 并 重新 组 织 那些 实例 ， 以 便 从 更 高 的 抽象 层面 上 去 看 待 它 
们 。 这 样 会 带 来 很 多 好 的 例子 ,但 有 时 也 会 导致 陷入 僵局 或 者 产生 不 
高 明 的 想法 。 我 们 没有 必要 捕获 所 有 过 渡 性 的 例子 ， 也 没有 必要 记录 
得 出 结果 的 过 程 。 

另 一 方面 ， 仪 仅 记录 下 那些 我 们 想 存 档 的 关键 实例 而 不 作 任 何 解 
释 ， 是 无 法 有 效 地 与 未 参与 过 讨论 的 人 一 起 沟通 需求 说 明 的 。 

成 功 的 团队 不 会 直接 使 用 原始 的 例子 ， 他 们 会 从 中 提炼 需求 说 
明 。 他 们 会 从 天 键 实例 中 提取 最 重要 的 特性 ， 将 其 转化 成 清晰 明确 的 
定义 ， 并 去 掉 不 相干 的 细节 ， 使 得 实现 变 得 完整 。 验 收 条 件 就 这 样 被 
记录 下 来 并 描述 清楚 ， 任 何人 在 任何 时 候 都 可 以 拿 到 最 终 的 需求 说 明 
并 读 懂 它 。 这 种 市 实例 的 需求 说 明 捕 获 了 让 人 满意 的 条 件 、 功 能 的 预 
期 输出 以 及 它 的 验收 测试 。 

实例 化 需求 说 明 就 是 验收 测试 

一 段 很 好 的 需求 说 明 ， 加 上 实例 ， 实 际 上 就 是 它 所 描述 的 功能 的 

验收 测试 。 


理想 情况 下 ， 带 实例 的 需求 说 明 应 该 从 业务 角度 出 发 清晰 地 定义 
所 需 的 功能 ， 而 不 是 去 定义 系统 应 该 如 何 实现 细节 。 这 样 ， 开 发 团队 
才 可 以 自由 地 找 出 符合 需求 的 最 住 方案 。 要 达到 这 样 的 目标 ， 需 求 说 
明 应 该 满足 以 下 条 件 : 

精确 、 可 测 ， 

是 真正 的 需求 说 明 ， 而 不 是 脚本 ; 

是 天 于 业务 功能 的 ， 而 不 是 天 于 软件 设计 的 。 

一 旦 完成 了 某 个 功能 ， 描 述 它 的 需求 说 明 就 会 派 上 其 他 用 场 。 它 
将 成 为 系统 功能 的 文 要 ， 并 提醒 我 们 功能 退化 的 情况 。 为 了 发 挥 它 作 
为 长 期 功能 文档 的 用 处 ， 我 们 所 编写 的 需求 说 明 必 须 能 让 其 他 人 在 创 
建 数 月 甚至 数 年 之 后 拿 起 依然 能 很 容易 地 理解 它 在 做 什么 、 为 什么 需 
要 它 ， 以 及 它 所 描述 的 是 什么 。 因 此 ， 需 求 说 明 应 该 是 : 

不 言 而 喻 的 ; 

专注 的 ; 

使 用 领域 语言 编写 的 。 

本 章 侧重 于 讲述 为 实现 以 上 目标 应 如 何 提炼 需求 说 明 。 但 是 首 
先 ， 为 了 从 更 加 具体 的 角度 去 看 待 事情 ， 我 将 展示 一 些 好 的 和 不 好 的 
需求 说 明 的 例子 。 在 本 章 结尾 ， 我 们 将 运用 本 章 给 出 的 建议 来 提炼 不 
好 的 需求 说 明 。 


8.1 一 个 SRI 


下 面 是 一 个 非常 好 的 带 实 例 的 需求 说 明 的 例子 。 

8.1.1 免费 送 货 服务 

当 VIP 客 户 购 买 一 定数 量 的 书籍 时 ， 就 为 他 们 提供 免费 送 货 服 
务 。 免 费 送 货 服务 不 提供 给 普通 客户 或 购买 非 书籍 的 VIP 客户 。 

假定 要 获得 免费 送 货 服务 ， 至 少 需要 购买 5 本 书籍 ， 那 么 我 们 会 得 
到 下 表 这 样 的 预期 : 


8.1.2 实例 


购物 车 中 的 物品 


VIP 客户 5 本 书 免费 ， 标 准 
VIP 客户 4 本 书 标准 
普通 客户 10 本 书 标准 
VIP 客 户 5 人 台 洗 衣 机 标准 
VIP 客 户 5 本 书 ，1 台 洗衣 机 标准 


该 需求 说 明 不 言 自明 。 我 经 常会 在 会 议 上 与 工作 坊 中 给 人 们 展示 
这 个 例子 ， 从 来 不 必 再 多 说 一 个 字 去 解释 它 。 标 题 与 引言 部 分 解释 了 
该 例子 的 结构 ， 读 者 不 需要 反 向 从 数据 去 理解 它 所 说 明 的 业务 规则 。 
其 中 也 包含 了 真实 的 例子 ， 这 让 需求 说 明 具 备 了 有 可 测 性 并 且 前 释 了 
边界 用 例 的 行为 ， 例 如 ， 如 果 人 们 买 了 10 本 书 又 将 如 何 。 

这 是 一 个 需求 说 明 ， 而 非 一 段 描述 人 们 如 何 测 试 这 些 例子 的 脚 
本 。 它 并 未 提 太 程序 工作 流 或 者 session 约 束 ， 也 未 说 明 如 何 购 买 图 
书 ， 而 只 是 说 明了 送 货 服务 的 机 制 。 它 并 非 要 讨论 任何 实现 细节 ， 那 
些 都 将 留 给 开发 人 员 以 最 佳 的 方式 去 实现 。 

该 需求 说 明 专 注 于 免费 送 货 服务 的 具体 业务 规则 ， 它 包含 的 只 是 
与 此 相关 的 那些 属性 。 


8.2 一 个 Ki 


与 前 面 的 需求 说 明 相 比 ， 图 8-1 所 示 的 实例 是 一 个 非常 差 的 需求 说 
HAO, 


注释 : QW 这 个 实例 来 自 于 真实 的 项 目 ， 包 含 在 原先 的 FitNesse 版 本 
中 。 在 2010 年 6 月 于 伦敦 举办 的 一 次 工作 坊 中 ， 我 们 将 其 作为 提炼 需求 
说 明 的 练习 。 最 终 ，FitNesse 发 行 版 本 中 的 例子 也 因此 做 了 变更 。 


简单 的 工资 单 验收 测试 
首先 我 们 增加 一 些 员 工 信 息 。 


姓名 工资 
Jeff Languid 10 Adamant St; Laurel MD 20707 1005.00 
Kelp Holland 128 Baker St; Cottonmouth, IL 60066 2000.00 


接 下 来 我 们 给 他 们 发 放 工 资 。 


支付 日 期 
支付 日 期 支票 号 码 
2001 年 1 月 31 日 1000 


我 们 要 确保 他 们 的 工资 数目 正确 。 空 白 的 格子 由 工资 检查 程序 的 测试 固件 (fixture) 来 填写 ， 已 经 填 和 的 
数据 将 会 受到 检查 。 


工资 检 


Id 金额 
1 1005 
2 2000 


最 后 我 们 要 确保 输出 数据 包含 且 仅 仅 包含 2 张 支票 信息 ， 并 且 支 票 号 码 都 正确 无 误 。 


工资 检查 程序 


号 码 
1000 
1001 


图 8-1 令 人 费解 的 需求 说 明 


尽管 这 些 表格 拥有 标题 ， 周 围 也 有 一 些 文字 ， 似 乎 解释 着 这 一 
切 ， 但 实际 上 却 没什么 效果 。 为 什么 这 份 文档 要 冠 以 “简单 ”两 字 ? 显 
然 ， 它 与 工资 单 有 关 ， 但 它 到 底 在 说 明 什 么 ? 

这 份 文档 在 说 明 什 么 实际 上 并 不 清楚 。 我 们 不 得 不 从 测试 数据 去 
理解 业务 规则 。 它 似乎 要 验证 打印 出 来 的 支票 必须 拥有 唯一 号 码 ， 号 
码 的 起 始 数 字 由 参数 指定 。 它 似乎 还 要 验证 每 张 支票 上 打印 的 数据 。 
同时 还 在 文字 中 描述 了 要 为 每 位 员工 打印 一 张 支票 。 

这 份 文 档 有 许多 地 方 容易 变 得 很 复杂 。 除 了 准备 阶段 (setup)， 文 
档 的 其 他 地 方 并 没有 用 到 姓名 和 地 址 。 表 格 里 出 现 了 数据 库 标识 符 


(id) 但 它们 与 业务 规则 毫 不 相干 。 该 实例 中 的 数据 库 标 识 符 用 于 在 工 
资 检查 程序 表格 中 匹配 员工 ， 这 让 需求 说 明 引 入 了 软件 技术 的 概念 。 
资 检查 程序 的 概念 显然 只 用 于 测试 的 目的 。 当 我 第 一 次 读 到 这 
个 实例 时 ， 我 想象 起 Peter Sellers 英 国 著 名 喜剧 演员 穿着 Clouseau 电 影 
ee 到 检查 支票 的 情景 。 我 确信 这 并 不 是 业务 概念 。 

一 个 有 趣 的 地 方 就 是 需求 说 明 断 言 部 分 的 空白 单元 格 ， 而 且 这 
ee 今 查 程 序 的 表格 看 起 来 似乎 是 没什么 关联 。 这 个 实例 来 自 
FitNesse， 这 个 工具 会 在 空白 单元 格 里 打印 出 测 域 结果 ， 用 于 故障 处 
理 ， 而 不 会 做 任何 检查 。 这 让 该 需求 说 明 变 成 了 大 家 必须 仔细 检查 的 
自动 化 测试 ， 几 乎 完全 违背 了 自动 化 的 目的 。FitNesse 的 测试 中 有 空 
单元 格 ， 这 通常 是 测试 不 稳定 的 一 个 迹象 ， 同 时 也 是 测试 存在 问题 的 

一 个 信号 。 要 么 该 自动 化 测试 与 系统 挂钩 的 地 方 不 对 ， 要 么 隐藏 有 洪 
在 规则 ， 使 得 测试 结果 变 得 不 可 重复 ， 而 且 不 可 靠 。 

该 需求 说 明 中 使 用 的 语言 也 不 统一 ， 这 使 得 输入 和 输出 很 难 进行 
关联 。 最 后 一 个 表格 里 的 数值 1001 代 表 什 么 意思 ? 列 名 说 这 是 一 个 号 
码 ， 它 确实 是 “号 码 ”， 但 是 说 了 等 于 没 说 ， 完 全 无 厘 头 。 第 二 个 表格 
有 一 列 支 票 号 码 ， 但 它 是 何 种 号 码 呢 ? 它们 两 者 之 间 有 什么 关系 呢 ? 

表格 里 包含 了 地 址 信息 ， 假 定 这 么 做 的 原因 是 ， 为 了 自动 化 包装 
而 打印 的 对 账单 必须 带 有 地 址 信息 ， 但 是 基于 该 需求 说 明 的 测试 至 少 
无 法 验证 一 件 非常 重要 的 事情 : 员工 们 能 否 各 自得 到 正确 的 工资 金 
额 。 如 果 表 格 中 的 第 一 个 人 同时 获得 了 这 两 张 支 票 ， 这 个 测试 会 顺利 
通过 。 如 果 他 们 两 个 各 自 拿 到 了 对 方 的 工资 ， 该 测试 也 会 通过 。 如 果 
支票 上 打印 的 日 期 在 很 久 的 将 来 ， 我 们 的 员工 很 可 能 无 法 吕 现 ， 但 测 
试 依然 会 通过 。 

现在 我 们 来 看 看 存在 空白 单元 格 的 真正 原因 。 支 票 没 有 指定 顺 
序 ， 这 是 一 个 功能 缺失 ， 使 得 系统 很 难 按照 可 重复 的 方式 进行 测试 。 
该 FitNesse 页 面 的 作者 决定 绕 开 这 个 需求 说 明 的 技术 难点 ， 他 没有 在 自 
动 化 层 上 去 做 这 件 事情 ， 而 是 创建 了 一 个 可 能 会 误 报 的 测试。 


没有 更 多 的 上 下 文 信息 ， 很 难 确定 这 个 测试 是 不 是 只 验证 单个 功 
能 。 如 果 支 票 打 印 系统 还 有 其 他 用 途 ， 我 更 愿意 把 “支票 号 码 是 唯一 的 
并 起 始 于 配置 的 值 ” 这 样 一 个 事实 分 开 到 单独 的 FitNesse 页 面 上 。 如 果 
我 们 只 打印 工资 支票 ， 那 很 可 能 这 个 需求 说 明 是 工资 支票 打印 功能 的 
一 部 分 。 

在 本 章 稍 后 ， 我 们 将 对 这 份 极 不 友好 的 文档 进行 提炼 。 但 是 首 
先 ， 让 我 们 回顾 一 下 什么 才 是 好 的 需求 说 明 。 


8.3 提炼 ki ` Ù 2 


在 本 章 的 介绍 部 分 ， 我 列举 了 一 些 好 的 需求 说 明 的 目标 。 下 面 是 
一 些 如 何 实现 这 些 目标 的 好 点 子 。 


8.3.1 Ay sil 


需求 说 明 必 须 是 衡量 成 功 与 否 的 客观 标准 ， 可 以 明确 地 告诉 我 们 
何 时 完成 了 开发 。 它 必须 包含 可 验证 的 信息 (输入 参数 与 预期 输出 的 
组 合 ) ， 可 用 来 对 系统 进行 检查 。 

为 了 满足 这 些 条 件 ， 需 求 说 明 必 须 基于 精确 的 、 实 际 的 例子 。 关 
于 如 何 确 保 实 例 的 精确 性 ， 请 参考 7.2 节 。 


8.3.2 = 
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作 ， 以 此 解释 他 们 将 如 何 使 用 系统 来 完成 某 件 事情 ， 而 不 是 解释 系统 
应 该 具有 什么 功能 。 此 类 实例 是 脚本 而 非 需 求 说 明 。 

脚本 解释 如 何 测 试 某 个 东西 。 它 通过 与 系统 较 低层 次 的 交互 描述 
业务 功能 。 脚 本 要 求 读 者 从 操作 开始 向 上 推导 ， 理 解 什么 是 真正 重要 
的 ， 以 及 它 到 底 在 描述 什么 。 脚 本 还 会 把 测试 与 工作 流 及 session 约 束 
混合 在 一 起 ， 即 使 背后 的 业务 规则 不 变 ， 将 来 它们 仍 有 可 能 会 改变 。 
需求 说 明 解 释 系统 在 做 什么 。 它 以 最 直接 的 方式 去 关注 业务 功 
需求 说 明 较 短 ， 因 为 它们 直接 描述 业务 概念 。 这 让 它们 比 脚 本 易 
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于 阅读 和 理解 。 同 时 需求 说 明 比 脚本 稳定 得 多 ， 因 为 工作 流 与 session 
约束 的 改变 不 会 影响 到 它们 。 

下 面 是 一 个 脚本 的 例子 。 

(1) 以 用 户 Tom 进 行 登录 。 

(2) 跳 转 到 主页 。 

(3) 搜索 《实例 化 需求 说 明 》。 

(4) 把 第 一 个 搜索 结果 加 入 到 购物 车 中 。 

(5) 搜索 《测试 之 美 》。 

(6) 将 第 二 个 搜索 结果 加 入 到 购物 车 里 。 

(7) 验证 购物 车 中 的 物品 数 是 否 为 2。 

这 个 脚本 告诉 我 们 某 件 事情 是 如 何 完成 的 ， 但 它 并 没有 直接 解释 
我 们 在 说 明 什 么 。 在 阅读 下 一 段 以 前 ， 请 先 拿 出 一 张 白 级 ， 试 着 写 下 
这 个 实例 到 底 在 说 明 什 么 。 事 实 上 你 能 写 下 一 些 东 西 吗 ? 如 果 可 以 做 
到 ， 你 觉得 它 是 这 个 例子 唯一 可 能 描述 的 东西 吗 ? 

这 个 实例 要 描述 的 东西 有 太 多 的 可 能 性 。 一 种 可 能 是 购物 车 可 以 
加 入 多 个 物品 。 另 一 种 可 能 是 用 户 登录 后 购物 车 是 空 的 。 第 三 种 可 能 
是 《实例 化 需求 说 明 》 的 第 一 个 搜索 结果 以 及 《测试 之 美 》 的 第 二 个 
搜索 结果 可 以 被 加 入 到 购物 车 中 。 

这 是 一 个 非常 精确 的 并 且 可 测试 的 实例 ， 我 们 可 以 执行 并 确认 系 
统 是 否 会 给 出 预期 的 结果 。 这 个 脚本 的 问题 在 于 它 没有 包含 任何 信 
息 ， 能 用 于 描述 它 实 际 代表 的 功能 。 编 写 这 个 脚本 的 人 在 首次 实现 这 
个 功能 时 ， 可 能 非常 清楚 地 了 解 它 应 该 具有 什么 样 的 行为 。 但 6 个 月 之 
后 ， 这 点 就 变 得 不 再 明显 了 。 

这 个 脚本 不 是 一 个 很 好 的 沟通 工具 。 实 际 上 我 们 没 办 法 说 清楚 它 
派 什 么 用 场 ， 也 不 清楚 系统 哪个 部 分 有 和 错误。 如果 基于 这 个 脚本 的 测 
试 突然 出 现 失败 ， 那 就 必须 要 有 人 人 花费 许多 时 间 去 分 析 不 同 地 方 的 代 
码 。 

脚本 开始 的 第 一 个 步 又， 要 求 以 用 户 tom 来 登录 ， 这 很 可 能 是 受 
到 网 站 工作 流 的 制约 。 除 非 这 个 实例 描述 的 业务 规则 与 这 位 特定 的 用 


户 有 关 ， 否 则 登录 用 户 是 否 是 tom 是 无 关 紧 要 的 。 如 果 他 的 账号 由 于 
某 种 原因 被 禁用 了 ， 那 么 这 个 测试 就 会 出 现 失败 ， 而 系统 本 身 却 不 一 
定 会 有 什么 问题 。 要 找到 这 个 测试 失败 的 原因 必然 会 浪费 很 多 时 间 。 
从 长 远 来 看 ， 使 用 脚本 而 不 是 需求 说 明 来 捕获 验收 测试 会 耗费 很 
多 时 间 ， 如 果 我 们 能 预先 用 几 分 钟 来 调整 那些 实例 的 结构 ， 那 么 就 可 
以 节省 很 多 时 间 。 关 于 如 何 把 这 样 的 脚本 提炼 成 有 用 的 需求 说 明 ， 请 
参考 本 章 结 尾 的 8.7 节 。Rick Mugridge 和 Ward Cunningham 在 Fit for 
Developing Software 一 书 中 提供 了 诸多 建议 ， 可 以 帮助 我 们 把 脚本 重组 


在 制定 一 种 真正 的 处 理 流程 ， 否 则 这 通常 是 使 用 脚本 来 描述 业务 规则 
的 信号 。 这 样 的 脚本 会 造成 许多 长 期 维护 的 问题 。 

-= 要 提防 关于 系统 应 该 如 何 工作 的 描述 。 我 们 应 当 去 考虑 系统 应 
该 做 什么 。 

Ian Cooper 位 于 Beazley 的 团队 在 开始 实施 实例 化 需求 说 明 6 个 月 后 
意识 到 了 这 一 点 。 在 一 次 团队 回顾 会 议 上 ， 他 们 开始 提出 自己 的 验收 
测试 维护 成 本 太 高 ， 并 开始 寻找 降低 成 本 的 方法 。 后 来 他 们 把 脚本 重 
组 成 了 需求 说 明 。Cooper 说 道 : 

“我 们 用 于 自动 化 测试 的 模型 与 手工 测试 的 模型 是 一 样 的 ， 都 把 测 
试 转化 成 了 脚本 。 我 们 的 早期 测试 遵循 了 脚本 化 的 方法 ， 测 试 就 是 一 
长 串 操作 ， 加 上 最 终 的 一 些 检查 。 一 旦 我 们 的 思维 转换 到 :系统 应 该 做 
什么 的 模式 上 ， 事 情 就 变 得 容易 多 了 。” 

把 验收 测试 描述 成 脚本 而 不 是 需求 说 明 ， 是 团队 在 早期 最 容易 犯 
的 一 个 错误 。 相 对 而 言 ， 把 脚本 作为 短 迭 代 的 开发 目标 来 使 用 是 比较 
好 使 的 ， 因 为 大 家 在 首次 实现 某 个 功能 时 ,仍然 会 记得 脚本 描述 的 内 
容 是 什么 。 但 想 要 在 今后 去 维护 并 理解 它们 都 会 比较 困难 。 这 个 问题 
可 能 要 在 数 月 之 后 才 会 浮现 ， 但 一 旦 出 现 ， 就 会 产生 严重 的 危害 。 


8.3.4 需求 说 明 应 关注 业 F 


原则 上 ， 需 求 说 明 不 应 该 牵涉 到 软件 设计 。 它 应 该 解释 业务 功 
能 ， 对 软件 如 何 实现 不 做 任何 规定 。 这 样 做 有 两 个 目的 : 

让 开发 人 员 在 当下 找 出 最 佳 的 解决 方案 ; 

让 开发 人 员 在 未 来 改善 他 们 的 设计 。 

关注 于 业务 功能 的 需求 说 明 ， 没 有 描述 实现 细节 ， 这 使 得 修改 实 
现 更 加 容易 。 当 软件 设计 得 到 改善 时 ， 没 有 谈 及 任何 软件 设计 的 需求 
说 明 就 无 需 进行 修改 。 这 样 的 需求 说 明 就 像 一 个 常量 ， 有 助 于 未 来 的 
变更 。 在 改善 软件 设计 之 后 ， 我 们 可 以 马上 执行 基于 那些 需求 说 明 的 
测试 ， 而 不 需要 对 它们 进行 修改 ， 以 此 确保 以 前 的 功能 仍然 可 以 正常 
运行 。 


~ 与 代码 紧密 耦 舍 、 严 密 体现 软件 实现 的 需求 说 明 会 让 测试 异常 
脆弱 。 

即使 测试 描述 的 业务 功能 没有 变动 ， 软 件 设 计 的 改动 也 会 破坏 这 
样 的 测试 。 那 些 产生 脆弱 测试 的 实例 化 需求 说 明 会 引入 额外 的 维护 成 


本 ， 而 非 辅 助 变更 。Aslak Hellesgy 指 出 了 这 一 点 ， 这 是 他 从 实例 化 需 
求 说 明 中 学 习 到 的 重要 一 课 : 

“我 们 编写 的 验收 测试 太 多 了 ， 有 时 候 它 们 与 我 们 的 代码 耦 舍得 太 
紧密 了 。 虽 然 不 如 单元 测试 那样 紧密 ， 但 仍然 耦 舍 着 。 在 最 差 的 情况 
下 ， 进 行 一 次 较 大 的 重 构 后 ， 需 要 花费 8 小 时 以 上 去 更 新 那些 测试 脚 
本 。 如 何在 编写 多 少 测试 以 及 如 何 编写 它们 之 间 找 到 一 个 良好 的 平衡 
E? 在 这 个 问题 上 ， 我 们 学 到 了 很 多 。” 

~ 要 当心 需求 说 明 中 来 自 软 件 实现 但 并 不 属于 业务 领域 的 名 称 和 
概念 。 比 如 说 数据 库 标识 符 (Id)、 技 术 服务 名 或 者 对 象 类 名 等 非 直接 
性 的 领域 概念 ， 以 及 纯粹 出 于 自动 化 目的 而 创造 的 概念 。 请 重组 这 些 
需求 说 明 ， 避 免 使 用 此 类 概念 ， 这 样 它 们 会 更 易于 理解 和 长 期 维护 。 

技术 性 测试 很 重要 ， 我 并 不 是 要 反对 此 类 与 软件 设计 紧密 关联 的 
测试 。 但 是 此 类 测试 不 应 该 与 可 执行 的 需求 说 明 相 混合 。 很 多 团队 开 
台 实 施 实例 化 需求 说 明 时 的 一 个 常见 错误 是 终止 所 有 的 技术 性 测试 ， 
比如 说 单元 测试 或 集成 测试 ， 并 期 望 可 执行 的 需求 说 明 会 覆 荔 到 系统 
的 所 有 方面 。 可 执行 的 需求 说 明 会 指引 我 们 交付 正确 的 业务 功能 。 技 
术 性 测试 可 以 确保 我 们 去 关注 系统 低层 次 的 技术 质量 方面 。 两 者 我 们 
都 需要 ， 但 我 们 不 应 该 把 它们 混合 到 一 起 。 技 术 性 测试 的 自动 化 工具 
比 我 们 用 来 自动 化 可 执行 需求 说 明 的 工具 更 适合 于 技术 性 测试 。 它 们 


遗留 系统 经 常会 有 许多 技术 怪癖 ， 而 且 它 们 难以 修改 。 用 户 必须 
绕 过 这 些 技术 难点 ， 而 且 区 分 实际 的 业务 流程 和 临时 的 解决 方法 会 变 
得 十 分 困难 。 

有 些 团队 会 挥 入 一 个 陷阱 ， 他 们 会 把 这 些 流程 的 临时 解决 方法 包 
含 到 需求 说 明 中 。 这 不 仅 会 把 需求 说 明 绑 定 到 实现 细节 上 ， 还 会 绑 定 
到 那些 技术 问题 上 上。 这样 的 需求 说 明 在 遗留 系统 中 没有 起 到 协助 变更 


的 作用 。 它 们 的 维护 成 本 很 快 就 会 变 得 非常 昂贵 。 对 代码 的 细小 改 
动 ， 都 有 可 能 需要 几 个 小 时 的 时 间 来 更 新 相关 的 可 执行 需求 说 明 。 
Johannes Link 曾 经 为 一 个 项 目 工作 过 ， 为 了 在 那个 项 目 中 运行 一 
些 基本 的 测试 场景 ， 必 须 构建 200 多 个 不 同 的 对 象 。 那 些 依赖 项 定义 在 
可 执行 的 需求 说 明 中 ， 而 没有 放 到 目 动 化 层 里 。 一 年 后 ， 测 试 维护 成 
变 得 非常 之 高 ， 以 至 于 团队 不 得 不 回 深 了 他 们 的 修改 。Link 说 : 
“修改 一 个 功能 会 破坏 许多 测试 。 他 们 无 法 去 实现 一 些 新 的 功能 ， 
因为 测试 的 维护 成 本 实在 太 高 了 ， 但 他 们 知道 自己 必须 保留 那些 测 
试 ， 以 便 保持 较 低 的 缺陷 率 。” 
大 多 数 可 执行 需求 说 明 的 自动 化 工具 2 会 把 需求 说 明和 自动 化 过 
程 分 离开 来 (详情 请 看 第 9 章 开 始 部 分 的 附注 栏 内 容 “ 其 原理 是 什 
么 ? ”) 。 需 求 说 明 是 按照 人 类 可 阅读 的 形式 记录 的 ， 而 自动 化 过 程 是 
利用 编程 语言 代码 的 形式 记录 在 单独 的 上 自动 化 层 中 的 。 


注释 : (关于 自动 化 工具 的 更 多 内 容 ， 请 访问 


http://specificationbyexample.como 


-把 技术 难题 放 到 自动 化 层 去 处 理 。 不 要 试图 在 测试 说 明 中 解 
决 。 

这 会 让 你 在 变更 和 改进 系统 时 更 加 容易 。 当 我 们 描述 和 维护 技术 
上 的 验证 过 程 时 ， 在 自动 化 层 上 解决 技术 难题 能 让 你 充分 利用 到 编程 
语言 的 特性 和 工具 。 程 序 员 可 以 运用 技术 和 工具 来 减少 重复 、 创 建 可 
维护 的 代码 ， 并 轻松 修改 它 。 如 果 技 术 上 的 临时 方案 包含 在 自动 化 层 
里 ， 那 么 当 你 改善 技术 上 的 设计 时 ， 需 求 说 明 就 可 以 不 受 影响 ， 而 临 
时 方案 也 就 不 再 需要 。 

将 技术 上 的 工作 流放 入 到 自动 化 层 里 也 可 以 让 需求 说 明 更 加 简 
短 ， 更 易于 理解 。 而 最 终 的 需求 说 明 则 会 以 更 高 的 抽象 级 别 来 解释 业 
务 概念 ， 并 侧重 于 对 特定 实例 集合 来 说 重要 的 那些 方面 (详情 请 见 本 
章 后 面 8.3.13 节 的 内 容 ) o 


适用 于 : Web 项 目 

=- 刚 开始 接触 实例 化 需求 说 明 时 ， 许 多 团队 会 浪费 很 多 时 间 为 用 
户 界 面 的 细节 描述 很 多 不 相干 的 例子 。 他 们 为 了 过 程 本 身 去 遵循 实例 
化 需求 说 明 的 实施 过 程 ， 而 不 是 为 了 增强 对 需求 说 明 的 理解 。 

用 户 界面 是 可 见 的 ， 因 此 它 很 容易 理解 。 我 见 过 一 些 项 目的 团队 
和 客户 ， 花 了 几 个 小 时 去 描述 导航 菜单 。 而 实际 上 这 部 分 的 用 户 界 面 
没有 什么 风险 ， 这 些 时 间 应 该 用 于 讨论 更 加 重要 的 功能 。 

Phil Cowans 在 Songkick 公 司 实施 实例 化 需求 说 明 的 时 候 就 有 过 这 
样 的 经 历 ， 他 认为 这 是 大 家 在 早期 会 犯 的 一 个 主要 错误 。 

“早期 的 时 候 ， 我 们 花费 了 太 多 时 间 去 测试 用 户 界面 的 琐碎 方面 ， 
因为 这 做 起 来 很 容易 。 我 们 没有 花费 足够 的 时 间 去 深入 边缘 情况 和 应 
用 程序 的 其 他 路 径 。 测 试看 得 见 的 东西 很 容易 ， 但 是 最 终 还 是 要 深入 
了 解 软 件 在 做 什么 ， 而 不 是 用 户 界面 看 起 来 怎么 样 。 考 虑 用 户 故事 以 
及 应 用 程序 的 路 径 确实 会 有 所 帮助 。” 

不 要 老 想 着 用 户 界 面 的 细节 ， 考 虑 用 户 在 站 点 上 的 操作 过 程 会 
加 有 用 。 协 作 制 定 需求 说 明 时 ， 应 当 按照 各 部 分 内 容 对 业务 的 重要 程 
度 来 投入 与 此 相称 的 时 间 。 重 要 的 、 高 风险 的 东西 应 该 仔细 探索 而 不 
必 对 那些 不 重要 的 东西 定义 得 那么 精确 。 


E> 


8.3.8 需求 说 明 应 该 是 不 言 


当 一 个 需求 说 明 由 于 功能 退化 测试 失败 时 ， 必 须 有 人 去 做 调查 ， 
了 解 哪里 出 现 了 问题 ， 并 找 出 解决 之 道 。 可 能 当 这 种 情况 出 现时 ， 需 
求 说 明 已 经 写 了 好 多 年 了 ， 当 初 编写 的 人 已 经 不 在 该 项 目 组 里 。 因 此 
需求 说 明 必 须 具备 不 言 自明 的 特质 就 显得 十 分 重要 了 。 

Pa ee eee E 


= 在 需求 说 明 开始 的 地 方 节 省 笔墨 可 以 产生 很 大 的 改观 ， 还 可 以 
为 今后 节约 许多 时 间 。 


如 果 需 求 说 明 只 包含 输入 与 预期 的 输出 ， 那 么 阅读 这 份 文档 的 人 
就 不 得 不 从 实例 中 重建 出 业务 规则 。 

为 需求 说 明 选 择 一 个 具有 叙述 性 的 标题 是 至 关 重 要 的 。 标 题 应 该 
要 总 结 出 需求 说 明 的 意图 。 假 设 你 在 搜索 Web 上 存放 的 需求 说 明 ， 那 
么 你 会 在 谷歌 的 搜索 框 中 输入 的 内 容 ， 就 应 当 是 你 的 标题 。 当 读者 搜 
索 某 个 功能 的 解释 时 ， 这 会 让 他 们 很 容易 找到 适当 的 需求 说 明 。 


搜索 程序 
其 余 的 搜索 引擎 
我 的 需求 说 明 的 标题 


同时 读者 也 要 了 解 需 求 说 明 的 结构 和 它 的 来 龙 去 脉 。 请 用 不 超过 
一 个 段落 的 篇 幅 去 解释 需求 说 明 的 目标 以 及 实例 的 结构 ， 并 将 它 放 在 
头 部 。 撰 写 描 述 有 一 个 很 好 的 诀 穷 ， 就 是 先 写 例子 ， 然 后 再 试 着 向 别 
人 解释 。 记 下 你 解释 例子 时 所 说 的 话 ， 并 将 其 放 到 需求 说 明 的 头 部 。 


am 


8.3.10 ETAJI F 


适用 于 : 独自 编写 需求 说 明 时 

目的 : 检查 需求 说 明 是 否 是 不 言 自明 的 

~ 为 了 检查 需求 说 明 是 否 是 不 言 自 明 的 ， 可 以 让 其 他 人 来 察看 文 
档 并 试 着 理解 它 ， 而 你 什么 都 不 要 说 。 

为 了 确保 需求 说 明 真 的 能 不 言 目 明 ， 可 以 请 其 他 人 来 解释 他 们 对 
需求 的 理解 ， 看 看 是 否 符合 你 的 意图 。 

当 我 向 别人 展示 需求 说 明 的 时 候 ， 如 果 我 发 现 目 己 必须 给 他 们 作 
解释 ， 我 会 号 下 这 些 解释 并 将 它们 放 到 头 部 。 解 释 这 些 实 例 通 常会 驱 
使 我 使 用 更 有 意义 的 名 字 ， 或 者 我 会 插入 一 些 注 解 ， 以 便 让 实例 更 易 
于 理解 。 
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8.3.11 过 


很 多 团队 会 在 他 们 架设 好 基本 的 自动 化 设施 后 ， 错 误 地 对 需求 说 
明 进 行 扩 展 ， 使 其 覆盖 输入 参数 所 有 可 能 的 组 合 。 对 这 种 做 法 ， 一 种 
常见 的 解释 是 测试 人 员 想 要 重用 自动 化 框架 来 验证 其 他 实例 。 

这 种 方式 的 问题 在 于 它 使 得 原 有 的 关键 实例 所 带 来 的 价值 被 显著 
淡化 。 需 求 说 明 变 得 难以 理解 ， 它 们 不 再 是 不 言 自明 的 。 

”~ 对 于 需求 说 明 而 言 ， 定 义 3 个 良好 的 关键 实例 比 定义 100 多 个 鉴 
脚 的 实例 来 得 更 加 有 用 。 

这 种 方式 的 另 一 个 问题 在 于 ， 为 了 验证 相同 的 情况 运行 更 多 的 实 
例 需要 更 多 时 间 ， 因 此 这 会 降低 测试 运行 的 速度 ， 使 交付 团队 获得 反 
馈 的 速度 变 慢 。 

Lisa Crispin 的 团队 在 进行 自动 化 的 兼容 性 测试 时 就 遭遇 了 这 种 问 
题 ， 当 时 监管 机 构 制定 了 一 些 规则 ， 而 这 些 规则 并 不 遵循 任何 他 辑 。 
Crispin 和 她 的 产品 负责 人 一 起 定义 了 一 些 算法 去 处 理 许多 排列 组 合 的 
情况 ， 因 此 ， 在 开发 工作 开始 之 前 ， 他 们 花 了 几 个 Sprint 的 时 间 编 瑟 了 
许多 复杂 的 可 执行 需求 说 明 。 当 开发 人 员 看 到 这 些 需 求 说 明 时 ， 他 们 
不 知 所 措 。 Crispin 详 细 描 述说 : 


“开发 人 员 看 到 这 些 测试 (可 执行 的 需求 说 明 ) 时 ， 感 到 非常 困惑 ， 
因为 这 让 他 们 :只 见 树木 不 见 森 林 :。 他 们 无 法 使 用 这 些 测试 ， 因 为 不 
知道 要 编写 什么 代码 。 因 此 我 们 发 现 测试 应 该 给 予 我 们 一 个 宏观 的 蓝 
图 ， 但 并 不 需要 马上 给 出 所 有 细节 。” 

需求 说 明 应 该 只 列 出 关键 的 具有 代表 性 的 实例 。 这 将 有 助 于 需求 
说 明 保 持 简 短 易 懂 。 关 键 实例 通常 具备 以 下 特点 。 


是 一 个 具有 代表 性 的 实例 ， 描 述 了 业务 功能 的 每 一 个 重要 方 
面 。 通 党 商业 用 户 、 分 析 师 或 者 客户 会 对 其 进行 定义 。 

它 会 描述 每 个 重要 技术 的 边缘 情况 ， 比 如 技术 上 的 边界 条 件 。 通 
常 当 开发 人 员 担 心 功能 分 歧 或 者 不 一 致 性 时 ， 他 们 会 举 出 这 样 的 例 
子 。 商 业 用 户 、 分 析 师 或 者 客户 则 会 对 其 定义 正确 的 预期 行为 。 

它 会 描述 预期 实现 的 每 一 个 未 手 之 处 ， 比 如 以 前 导致 缺陷 的 情 
况 ， 或 者 在 以 前 的 实例 中 没有 描述 清楚 的 边界 条 件 。 通 常 测试 人 员 会 
列举 出 这 种 例子 ， 而 商业 用 户 、 分 析 师 或 者 客户 则 会 定义 它 的 正确 行 
为 。 


当然 ， 为 了 关键 实例 重用 已 经 实施 的 自动 化 结构 ， 以 支持 那些 想 
做 更 多 测试 的 测试 人 员 ， 这 是 有 好 处 的 。 有 时 候 我 们 会 利用 不 同 的 边 
界 值 来 探索 系统 行为 ， 最 简单 的 方法 是 在 现 有 需求 说 明 上 绑 定 更 多 实 
例 。 这 会 使 得 需求 说 明 变 得 太 长 、 不 够 专注 ， 而 且 难 以 理解 。 

不 要 让 主 需 求 说 明 变 得 太 复杂 ， 你 可 以 新 建 一 个 单独 的 自动 化 测 
试 ， 并 在 主 需求 说 明 中 指出 哪里 可 以 找到 它 。 如 果 你 使 用 基于 Web 的 
活 文档 ， 那 么 可 以 使 用 Web 链 接 把 两 个 页 面 连接 起 来 。 如 果 你 使 用 的 
是 基于 文件 的 系统 ， 那 么 可 以 在 需求 说 明 的 描述 中 附 上 一 个 文件 路 径 
或 其 快捷 方式 。 

新 测试 的 结构 可 以 跟 原 先 的 需求 说 明 保 持 一 致 ， 并 列 出 许多 其 他 
实例 。 某 个 功能 的 主 需求 说 明 仍然 是 有 用 的 ， 它 是 一 个 沟通 工具 并 可 
以 提供 快速 有 反馈。 为 了 进行 广泛 的 测试 ， 其 他 测试 可 以 探索 所 有 不 同 
的 组 合 。 每 次 修改 都 可 以 对 主 需 求 说 明 进 行 验证 ， 以 便 提供 快速 的 反 
馈 。 而 补 元 测试 则 随时 可 以 通宵 运行 ， 以 便 让 团队 对 所 有 额外 情况 建 
立信 心 。 

不 要 试图 覆盖 所 有 情况 

过 度 定义 实例 的 一 个 常见 原因 是 分 析 师 或 客户 害怕 自己 由 于 遗漏 
功能 而 受 责备 。 在 协作 制定 需求 说 明 的 过 程 中 ， 获 取 正 确 的 需求 说 明 
是 大 家 共同 的 责任 ， 因 此 没有 理由 那么 做 。André Brissette 是 Pyxis 公 
司 Talia 产 品 的 总 监 ， 他 指出 这 是 他 学 到 的 一 个 重要 教训 : 

“覆盖 什么 不 覆盖 什么 ， 取 决 于 故事 成 功 的 条 件 。 如 果 你 觉得 那些 
测试 真 的 能 够 覆盖 成 功 的 条 件 ， 那 就 没有 问题 。 如 果 不 是 ， 那 就 有 问 
题 。 在 sprint 结 束 之 时 ， 或 者 事后 最 终 发 现 遗 漏 了 什么 ， 那 么 有 一 件 
事情 是 很 清楚 的 : 你 所 做 的 事情 就 是 取得 成 功 的 条 件 ， 这 也 是 大 家 一 
致 认同 的 。 这 样 看 来 ， 其 他 功能 就 是 多 余 的 。 作 为 一 名 分 析 师 ， 你 不 
必 有 承担 责任 。” 


8.3.12 从 简单 的 例子 入 手 ， 然 后 逐步 展开 
适用 于 : 使 用 许多 参数 组 合 描述 业务 规则 


为 了 解决 前 一 节 中 描述 的 问题 ，Crispin 的 团队 决定 在 开始 实现 故 
事前 只 编号 高 层次 的 需求 说 明 ， 详 细 的 测试 留 到 以 后 再 说 。 

当 测 试 人 员 和 开发 人 员 一 起 实现 一 个 故事 时 ， 他 们 会 制定 一 个 容 1 
易 通过 测试 的 路 径 。 然 后 开发 人 员 去 实现 自动 化 需求 说 明 并 编写 代 
码 ， 同 时 允许 测试 人 员 重 用 自动 化 框架 并 增加 测试 用 例 。 然 后 测试 人 
员 去 探索 系统 ， 使 用 不 同 的 例子 来 做 试验 。 如 果 他 们 找到 一 个 失败 的 
测试 用 例 ， 就 会 回 到 程序 员 那 里 ， 扩 展 相 关 的 需求 说 明 并 修正 问题 。 

~ 不 要 让 需求 说 明 过 于 复杂 ， 基 本 的 例子 有 助 于 我 们 找到 容易 通 
过 的 路 径 ， 并 让 自动 化 结构 落实 到 位 。 

然后 ， 我 们 可 以 基于 风险 逐步 尝试 其 他 例子 ， 并 逐渐 扩展 需求 说 
明 。 对 于 在 一 开始 不 易 确 定 等 价 类 的 情况 ， 以 及 边界 案例 由 具体 实现 
驱动 的 情况 来 说 ， 这 是 一 种 十 分 有 趣 的 解决 方案 。 


8.3.13 需求 i > 


一 个 需求 说 明 应 该 单独 描述 一 件 事情 : 一 条 业务 规则 、 一 个 功 
能 ， 或 者 过 程 的 一 个 步骤 。 专 注 的 需求 说 明 比 那 种 定义 多 个 相关 规则 


的 需求 说 明 要 容易 理解 。 同 时 需求 说 明 应 该 只 专注 于 例子 的 关键 属 
性 ， 这 些 属性 对 其 试图 展示 的 内 容 来 说 必须 是 非常 重要 的 。 

专注 对 于 需求 说 明 有 两 个 重要 的 好 处 。 首 先 ， 专 注 的 需求 说 明 比 
较 简短 ， 因 此 相对 于 长 的 、 不 够 专注 的 需求 说 明 来 说 更 容易 理解 。 其 
次 ， 它 们 还 更 易于 维护 。 当 系统 有 关 的 所 有 方面 中 某 一 方面 有 所 变动 
时 ， 一 个 履 盖 多 个 规则 的 需求 说 明 会 受到 影响 ， 这 会 让 基于 此 需求 说 
明 的 自动 化 测试 遭受 更 为 频繁 的 破坏 。 更 糟 糙 的 是 ， 当 这 样 的 测试 失 
败 时 ， 很 难 找到 问题 的 症结 。 

8.3.14 Ki “Given-When-Then”’ HÈ 
目的 : 让 测试 更 容易 理解 
> 一般 来 说 ， 一 个 需求 说 明 应 该 要 声明 上 下 文 环境 ， 指 定 一 个 单 
一 的 动作 ， 然 后 定义 好 预期 的 后 置 条 件 。 

可 以 提醒 我 们 这 么 做 的 一 个 好 方法 是 使 用 Given-When-Then 或 者 
Arrange-Act-Asserto Given-When-Then 是 定义 系统 行为 的 一 种 常见 格 
式 ， 它 由 早期 的 关于 行为 驱动 开发 的 文章 推广 开 来 。 它 要 求 我 们 以 3 个 
部 分 来 编写 系统 行为 的 场景 : 

假定 (Given) 一 个 前 提 5 

当 (When) 某 个 行为 发 生 时 ; 

那么 (Then) 后 置 条 件 就 会 得 到 满足 。 

有 些 自动 化 工具 ， 比 如 CucumberD flSpecFlow? ， 在 编写 可 执行 
的 需求 说 明 时 ， 要 求 准 确 地 使 用 这 种 语言 。 图 8-1 就 是 一 个 例子 。 即 便 
是 那些 使 用 表格 、 基 于 关键 字 或 者 自由 文本 系统 的 工具 ， 按 照 Given- 
When-Then 的 格式 来 组 织 需 求 说 明 也 是 一 个 非常 好 的 想法 。 


注释 : (CDhttp:/www.cukes.info 
注释 : @http://specflow.org 


只 触发 一 个 动作 是 至 关 重 要 的 。 这 可 以 确保 需求 说 明 只 专注 于 该 
动作 。 如 果 需 求 说 明 列 举 出 了 几 个 动作 ， 那 么 为 了 理解 最 终 的 结果 ， 


读者 就 必须 分 析 并 理解 这 些 动作 是 如 何 进行 协作 的 。 

如 果 一 组 动作 从 业务 流 的 角度 来 看 显得 十 分 重要 ， 那 么 给 它 起 个 
名 字 ， 并 把 它 作 为 更 高 层次 的 概念 来 使 用 ， 或 许 就 比较 重要 了 。 这 样 
它 在 领域 代码 中 就 应 该 以 更 高 层次 的 方法 来 捕获 ， 然 后 这 个 更 高 层次 
的 方法 就 可 以 在 需求 说 明 中 列举 出 来 。 

需求 说 明 仍然 可 以 定义 几 个 前 置 条 件 和 后 置 条 件 (在 Given 和 Then 
部 分 定义 多 个 条 款 )， 前 提 是 它们 与 测试 定义 的 功能 有 直接 关系 。 下 面 
这 个 Cucumber 测 试 的 例子 就 有 2 个 前 置 条 件 和 2 个 后 置 条 件 。 

Scenario: 新 用 户 ， 可 疑 交 易 

Given 一 个 用 户 以 前 从 没有 交易 记录 ， 

And 用 户 账 户 的 注册 地 是 英国 ， 

When 用 户 发 出 一 个 运送 到 美国 的 订单， 

Then 这 笔 交 易 要 标识 成 可 疑 交 易 ， 

But 用 户 看 到 的 订单 状态 是 “ 挂 起 ”。 

使 用 Given-When-Then 的 一 个 潜在 缺点 是 它 像 散文 ， 它 往往 会 吸 
引 大 家 去 考虑 交互 的 流程 ， 而 不 是 考虑 如 何 直接 描述 业务 功能 。 请 利 
用 本 章 之 前 8.3.2 节 中 的 建议 来 避免 此 类 问题 。 


适用 于 : 处 理 复杂 的 依赖 (或 引用 的 完整 性 ) 时 

在 那些 需要 复杂 配置 的 数据 驱动 项 目 中 ， 对 象 一 般 都 不 能 被 单独 
创建 。 例 如 ， 一 个 支付 方法 的 领域 验证 规则 可 能 要 求 它 必须 属于 某 个 
客户 ， 而 该 客户 必须 拥有 一 个 有 效 的 账户 ， 如 此 等 等 。 

~ 许多 团队 会 错误 地 把 所 有 先决 条 件 的 配置 和 设置 放 入 到 需求 说 
明 中 。 尽 管 从 概念 上 来 说 ， 这 会 让 需求 说 明 清楚 完整 ， 但 同时 它 会 让 
需求 说 明 难 以 阅读 和 理解 。 

此 外 ， 在 配置 中 对 任何 对 象 或 属性 的 修改 都 会 破坏 基于 这 个 需求 
说 明 的 测试 ， 即 使 它 与 描述 的 业务 规则 没有 直接 关系 。 

清晰 地 描述 所 有 的 依赖 还 会 隐藏 数据 相关 的 问题 ， 因 此 在 数据 驱 
动 的 项 目 中 这 是 尤其 危险 的 。 


Jonas Bandi 曾 经 参与 过 一 个 项 目 ， 为 学 校 重 写 一 个 遗留 的 数据 管 
理 系统 ， 他 们 遇 到 的 一 个 最 大 问题 与 了 解 现 有 的 数据 有 天。 他 们 的 团 
队 编 写 了 需求 说 明 ， 用 于 动态 地 建立 整套 上 下 文 环境 。 需求 说 明 中 的 
上 下 文 是 团队 基于 自己 的 理解 定义 的 ， 并 不 是 依照 真实 数据 的 变化 来 
制定 的 。 只 有 当 他 们 把 代码 和 来 自 于 遗留 系统 的 数据 连接 起 来 的 时 
候 ， 他 们 才能 检测 到 需求 中 的 许多 分 歧 和 不 一 致 之 处 ， 而 这 时 已 经 是 
迭代 中 期 了 (参见 7.4 节 ) o 

Bekk 咨 询 公 司 的 团队 在 挪威 的 Dairy Herd Recording System 项 目 中 
遇 到 了 类 似 的 问题 ， 但 他 们 的 角度 不 同 。 他 们 的 项 目 也 是 数据 驱动 
的 ， 许 多 对 象 都 需要 复杂 的 构建 过 程 。 起 初 ， 他 们 在 每 个 可 执行 的 需 
求 说 明 中 定义 整套 上 下 文 环境 。 这 要 求 大 家 完全 猜测 出 所 有 依赖 。 如 
果 遗 漏 了 一 些 数据 ， 那 么 即使 正确 地 实现 了 代码 ， 基 于 这 些 需 求 说 明 
的 测试 也 会 因为 数据 完整 性 的 约束 而 失败 。 

这 些 问题 可 以 在 自动 化 层 而 不 是 晨 需 求 说 明 中 得 到 很 好 的 解决 。 
把 所 有 跟 需 求 说 明 的 目标 不 相干 的 依赖 全 部 移入 到 自动 化 层 中 ， 并 保 
持 需 求 说 明 只 专注 于 重要 的 属性 和 对 象 。 同 时 请 参考 9.5 节 ， 那 里 会 介 
绍 一 些 不 错 的 解决 方案 ， 可 用 于 解决 技术 上 的 数据 管理 问题 。 


8.3.16 动 化 层 中 应 $ 


=> 创建 有 效 的 对 象 是 自动 化 层 的 职责 。 

目 动 化 层 可 以 使 用 合理 的 缺 省 值 预先 填充 对 象 ， 并 建立 起 相关 依 
赖 ， 这 样 我 们 就 不 必 显 式 地 对 它们 进行 说 明 。 这 使 得 我 们 在 编写 需求 
说 明 的 时 候 只 关注 于 重要 的 属性 ， 以 让 需求 说 明 更 容易 理解 和 维护 。 

例如 ， 在 用 户 进 行 支付 之 前 ， 我 们 无 需 了 解 创 建 一 个 客户 所 需 的 
所 有 的 地 址 信息 ， 以 及 为 其 注册 一 张 有 效 信用 卡 所 需 的 所 有 信用 卡 属 
性 ， 只 需 说 明 他 的 卡 上 有 100 美 金 即 可 。 其 他 的 都 可 以 由 自动 化 层 动态 
构造 。 

这 样 的 缺 省 值 可 以 在 自动 化 层 中 设 定 ， 也 可 以 在 全 局 的 配置 文件 
中 提供 ， 具 体 取决 于 商业 用 户 是 否 可 以 对 它们 进行 修改 。 


v 


8.3.17 总 是 $ 


GAT: 有 许多 属性 的 对 象 

虽然 合理 的 缺 省 值 让 需求 说 明 更 容易 编写 和 理解 ， 但 有 些 团队 会 
过 度 运 用 这 种 方式 。 在 编程 语言 中 消除 重复 通常 是 一 种 很 好 的 做 法 ， 
但 对 需求 说 明 而 言 却 不 见得 如 此 。 

- 如果 一 个 实例 的 关键 属性 与 自动 化 层 提 供 的 缺 省 值 相 匹配 ， 尽 
管 可 以 省 略 ， 但 显 式 地 对 其 进行 说 明 仍然 是 明智 的 做 法 。 

这 可 以 确保 需求 说 明 对 读者 而 言 拥 有 一 个 完整 的 上 下 文 环境 ， 同 
时 也 让 我 们 可 以 在 目 动 化 层 中 修改 那些 缺 省 值 。Ian Cooper 和 警告 说 : 

“尽管 一 个 实例 的 属性 实际 上 与 缺 省 值 是 一 样 的 ， 但 请 不 要 依赖 于 
它 。 要 明确 地 对 其 进行 定义 ， 这 样 我 们 今后 就 可 以 修改 那些 缺 省 值 。 
这 也 使 得 重要 内 容 变 得 显而易见 。 当 你 读 到 需求 说 明 的 时 候 ， 你 可 以 
看 到 有 些 例 子 对 这 些 产品 有 关 的 数值 进行 了 说 明 ， 这 时 你 就 可 以 提 
出 : ‘为 什么 这 很 重要 ? ” 


8.3.18 需求 说 明 应 语言 


功能 性 的 需求 说 明 对 用 户 、 业 务 分 析 师 、 测 试 人 员 、 开 发 人 员 以 
及 任何 想 要 了 解 系统 的 人 都 十 分 重要 。 为 了 让 需求 说 明 便 于 这 些 用 户 
组 的 人 员 访 问 和 阅读 ， 需 求 说 明 必 须 用 每 个 人 都 能 理解 的 语言 来 编 
写 。 文 档 中 使 用 的 语言 也 必须 一 致 。 这 会 最 大 限度 地 减少 翻译 的 需要 
以 及 误解 的 可 能 性 。 

统一 语言 (Ubiquitous language， 请 看 下 文 附注 栏 ) 非 党 符合 以 上 的 
要 求 。 要 确保 你 在 需求 说 明 中 使 用 统一 语言 ， 并 且 当 心 那 些 似乎 是 出 
于 测试 目的 而 创建 ， 听 起 来 却 又 像 是 软件 实现 概念 的 类 名 或 概念 。 

统一 语言 

软件 交付 团队 经 常会 基于 技术 上 的 实现 概念 为 项 目 开 发 他 们 自己 
的 术语 。 这 些 术语 不 同 于 商业 用 户 的 术语 ， 以 致 于 当 与 商业 用 户 进 行 
交流 时 经 常 需 要 翻译 。 业 务 分 析 师 就 扮演 了 翻译 者 的 角色 ， 并 成 了 信 


息 的 瓶颈 。 这 两 套 术 语 之 间 的 翻译 常常 会 导致 信息 丢失 ， 并 产生 误 
解 。 

Eric Evans 建 议 发 展 一 套 通用 的 语言 ， 在 领域 驱动 的 设计 中 作为 
对 领域 共同 理解 的 基础 ， 而 不 是 去 舍 并 不 同 的 术语 。 他 把 这 种 语言 
为 统一 语言 。 

如 果 能 确保 需求 说 明 实 现 本 节 所 列 出 的 目标 ， 我 们 就 会 得 到 一 个 
很 好 的 开发 有 目标， 而且 会 得 到 拥有 长 期 价值 、 可 以 作为 交流 工具 的 文 
档 。 它 们 会 支持 我 们 演化 系统 并 逐步 建立 起 活 文档 。 


8.4 提炼 


现在 让 我 们 清理 并 改进 一 下 本 章 前 面 提 到 的 劣质 的 需求 说 明 。 首 
先 ， 我 们 要 给 它 一 个 漂亮 的 叙述 性 的 标题 ， 比 如 “薪资 支票 打印 "， 这 
可 以 确保 我 们 今后 很 容易 就 能 找到 它 。 同 时 我 们 应 该 增加 一 个 段落 解 
释 需 求 说 明 的 目标 。 我 们 确定 了 以 下 规则 。 

系统 为 每 位 员工 打印 一 张 支票 ， 上 面包 含 员 工 姓名 、 地 址 以 及 工 
资金 额 。 

系统 在 支票 上 打印 出 支付 日 期 。 

票 号 码 是 唯一 的 ， 从 下 一 个 可 用 的 支票 号 码 开始 ， 按 照 从 小 到 
大 的 顺序 打印 。 

支票 按照 员工 姓名 的 字母 顺序 打印 。 

支票 上 有 收 款 人 姓名 、 金 额 以 及 付款 日 期 。 上 面 没 有 名 字 或 新 资 
数据 ， 那 些 是 员工 的 属性 。 如 果 我 们 把 打印 的 支票 作为 即将 自动 发 运 
出 去 的 信件 的 一 部 分 ， 那 么 我 们 就 可 以 说 支票 上 还 有 地 址 信息 ， 自 动 
信封 包装 也 可 以 使 用 这 一 信息 。 让 我 们 坚持 使 用 统一 语言 并 一 致 地 使 
用 这 些 名 词 。 

名 字 和 地 址 的 组 合 应 该 足以 让 我 们 匹配 到 员工 的 支票 一 一 我 们 不 
需要 数据 库 标 识 符 。 

通过 对 订购 规则 (无 论 是 什么 规则 ) 达成 一 致 ， 我 们 可 以 让 系统 
更 具 可 测 性 。 例 如 ， 我 们 可 以 接受 按 员 工 姓名 的 字母 顺序 来 打印 支 


票 。 我 们 可 以 建议 客户 那么 做 ， 这 可 以 让 需求 说 明 更 加 有 力 。 

为 了 让 需求 说 明 不 言 自明 ， 让 我 们 把 上 下 文 环 境 抽出 来 放 到 头 
部 。 工 资 日 期 、 下 一 个 可 用 的 支票 号 码 以 及 员工 的 薪资 数据 都 是 上 下 
文 环境 的 一 部 分 。 我 们 还 应 该 清楚 地 说 明 这 些 数字 有 什么 作用 ， 这 样 
今后 大 家 阅读 这 个 需求 说 明 的 时 候 就 不 必 自 己 去 弄 清 楚 这 一 点 了 。 让 
我 们 称 其 为 “下 一 个 可 用 的 支票 号 码 ”。 还 可 以 将 上 下 文 环境 显 式 地 提 
取出 来 ， 表 明 它 只 负责 准备 数据 而 不 会 进行 验证 ， 这 会 让 需求 说 明 更 
容易 理解 。 

触发 动作 并 不 一 定 要 在 需求 说 明 中 列 出 来 。 检 查 工 资 单 输出 结果 
的 表格 可 以 隐 性 地 运行 工资 核算 程序 。 这 是 一 个 例子 ， 让 我 们 专注 于 
正在 测试 什么 ， 而 不 要 去 关心 如 何 进行 检查 。 没 有 必要 设立 一 个 单独 
的 步 又 表明 “下 一 步 ， 我 们 向 他 们 进行 支付 ”。 

资 检查 程序 是 我 们 发 明 出 来 的 概念 ， 它 违背 了 统一 语言 的 规 

则 。 它 在 业务 领域 中 不 是 一 个 5 专 有 的 概念 ， 所 以 让 我 们 解释 一 下 它 究 
况 是 做 什么 的 。 因 为 我 们 想 确 保 无 论 谁 执 行 了 自动 化 验证 ， 都 必须 检 
查 所 有 打印 出 来 的 支票 ， 让 我 们 就 说 “所 有 的 支票 都 打印 完成 "好 了 。 
要 不 然 ， 可 能 有 人 使 用 子 集 去 匹配 ， 也 可 能 系统 会 每 张 支票 打印 两 
次 ， 而 我 们 不 会 注意 到 这 些 情况 。 

清理 好 的 版 本 如 图 8-2 所 示 。 


薪资 支票 打印 
系统 会 自动 打印 薪资 支票 : 
口 每 位 员工 一 张 支票 ， 支票 上 有 员工 姓名 、 地 址 以 及 某 资 数据 ， 
口 使 用 发 薪 日 期 ; 
口 支票 号 码 是 唯一 的 ; 
口 下 一 个 可 用 的 支票 号 码 是 按 升序 排序 的 ， 
口 按照 员工 姓名 的 字母 顺序 进行 打印 。 


V 薪资 上 下 文 

发 薪 日 期 10/10/2010 

下 一 个 可 用 的 支票 号 码 1000 

系统 中 的 员工 

姓名 地 址 Lit 
Jeff Languid 10 Adamant St; Laurel MD 20707 1005.00 
Kelp Holland 128 Baker St; Cottonmouth, IL 60066 2000.00 


执行 期 内 ， 所 有 的 支票 都 打印 完成 
日 期 收 款 人 地 址 金额 


10/10/2010 Jeff Languid 10 Adamant St: Laurel MD 20707 1005.00 
10/10/2010 Kelp Holland 128 Baker St; Cottonmouth, IL 60066 2000.00 


图 8-2 对 图 8-1 显 示 的 劣质 需求 说 明 提 炼 后 的 版 本 。 注 意 它 更 为 简短 ， 
而 且 是 不 言 自 明 的 ， 同 时 还 有 一 个 清晰 的 标题 


与 原先 的 需求 说 明 相 比 ， 这 个 版 本 更 加 简短 ， 并 且 不 容易 发 生 混 
乱 。 它 要 容易 理解 得 多 。 在 提炼 完 需 求 说 明之 后 ， 我 们 可 以 尝试 回答 
这 个 问题 : “我 们 有 遗漏 的 地 方 吗 ? ”通过 对 输入 参数 进行 试验 ， 并 考 
虑 那些 可 能 属于 有 效 输入 却 违反 业务 规则 的 边缘 情况 ， 我 们 可 以 确定 
这 个 需求 说 明 是 否 完整 。 没 有 必要 考虑 无 效 的 员工 数据 ， 因 为 这 应 该 
由 系统 的 其 他 部 分 去 检查 。 

一 种 启发 式 的 试验 数据 是 使 用 数值 的 边界 条 件 。 例 如 ， 如 果 员工 
的 工资 是 0 会 怎样 ?这 是 一 个 有 效 的 用 例 。 一 个 员工 可 能 请 了 无 薪 假 期 
或 者 合同 暂停 了 ， 又 或 者 他 已 经 离职 了 。 我 们 仍旧 打印 支票 吗 ? 如 果 
我 们 遵守 “一 位 员工 一 张 支票 ”的 规则 ， 那 么 对 于 任何 一 位 几 年 前 就 解 
雇 了 的 员工 ， 叶 然 不 再 向 其 支付 工资 ， 但 系统 仍然 会 打印 出 一 张 支 


票 ， 只 不 过 上 面 的 金额 是 0。 我 们 可 以 和 业务 人 员 进 行 讨 论 ， 加 强 一 下 
这 条 规则 ， 确 保 没 有 必要 的 时 候 就 不 要 打印 支票 。 

也 许 我 们 想 对 需求 说 明 做 进一步 的 提炼 并 将 其 拆 分 成 多 个 需求 说 
明 ， 这 取决 于 工资 单 是 否 是 支票 打印 的 唯一 用 例 。 有 人 可 能 会 描述 通 
用 的 支 泽 打印 功能 ， 比如 唯一 顺序 的 支票 号 码 。 还 有 人 可 能 会 描述 工 

资 单 打印 特有 的 功能 ， 比 如 打印 的 支票 数量 、 正 确 的 工资 金额 ， 等 
等 
与 工具 无 关 

很 多 人 会 因为 像 图 8-1 所 示 那 样 的 可 执行 需求 说 明 验 证 失败 了 而 抱 
怨 FitNesse。 诸 如 concordion 之 类 的 工具 意图 防止 此 类 问题 。 其 他 工具 
(比如 Cucumber) 则 提升 了 Given-When-Then 的 文本 结构 ， 以 试图 
避免 难以 理解 的 表格 。 

且 不 要 过 早 下 定 结论 认定 某 个 工具 是 某 种 问题 的 解决 方案 ， 要 知 
道 我 同样 看 到 过 许多 劣质 需求 说 明 ， 它 们 几乎 都 是 由 主流 工具 编写 
的 。 问 题 的 症结 不 在 于 工具 ; 同样 ， 解 决 方案 也 与 工具 无 关 。 问 题 的 
大 部 分 原因 是 团队 没有 投入 精力 让 需求 说 明 易 于 理解 。 提 炼 需 求 说 明 
无 需 多 花 很 多 精力 ， 却 可 以 带 来 更 多 的 价值 。 

提炼 需求 说 明 的 益处 有 了 时候 并 不 能 立马 显现 ， 因 为 协作 可 以 帮助 
我 们 对 预期 的 功能 建立 起 共识 。 这 就 是 为 什么 许多 团队 并 不 认为 提炼 
需求 说 明 很 重要 ， 最 终 导 致 出 现 大 量 难 以 理解 的 文档 的 原因 。 从 关键 

实例 开始 提炼 是 至 关 重 要 的 步骤 ， 这 可 以 确保 我 们 的 需求 说 明 作 为 沟 
通 工具 具有 长 期 的 价值 ， 同 时 它们 可 以 为 活 文档 系统 创建 恨 好 的 基 
Fillo 


8.5 铭记 
不 要 直接 使 用 最 初 的 实例 ， 要 对 它们 进行 提炼 ， 以 得 出 需求 说 
明 。 


为 了 充分 利用 实例 ， 最 终 的 需求 说 明 应 该 是 精确 的 、 可 测 的 、 不 
言 自明 的 、 专 注 的 ， 并 以 领域 语言 编写 ， 同 业务 功能 相关 。 


在 需求 说 明 中 要 避免 使 用 脚本 ， 避 免 谈 及 软件 设计 。 

不 要 试图 覆盖 所 有 用 例 。 需 求 说 明 不 是 用 来 上 符 代 组 合 回归 测试 
的 。 

所 有 重要 的 用 例 集 ， 都 要 先 从 一 个 例子 开始 着 手 ， 并 增加 值得 程 
序 员 和 测试 人 员 特 别 关 心 的 例子 。 

在 需求 说 明 、 软 件 设 计 以 及 测试 中 定义 并 使 用 统一 语言 。 


9 — s E y S 


提炼 好 功能 的 需求 说 明之 后 ， 我 们 就 有 了 实现 要 达到 的 清晰 目 
标 ， 并 且 有 了 一 个 精确 的 方式 来 衡量 何 时 已 经 实现 了 该 目标 。 每 当 系 
统 有 所 变更 ， 提 炼 过 的 需求 说 明 就 可 以 用 来 检查 原 有 功能 是 否 依然 生 
效 。 由 于 举例 说 明 的 内 容 太 过 详细 ， 我 们 无 法 在 短 迭 代 内 手动 执行 所 
有 检查 ， 即 使 是 中 型 项 目 也 无 法 做 到 。 一 个 显而易见 的 解决 方案 就 是 
尽 可 能 地 将 这 些 检查 工作 目 动 化 。 

自动 化 验证 带 实例 的 需求 说 明 与 传统 软件 项 目 中 的 测试 自动 化 有 
所 不 同 。 如 果 我 们 在 目 动 化 过 程 中 必须 大 量 地 更 改 需求 说 明 ， 那 么 我 
们 将 再 次 陷入 “ 传 话 游戏 ”的 困境 ， 并 且 还 会 失去 提炼 需求 说 明 带 来 的 
价值 。 理 想 情 况 下 ， 在 自动 化 需求 说 明 的 验证 过 程 中 ， 我 们 不 能 扭曲 
任何 信息 。 因 此 ， 它 比 传统 的 测试 自动 化 更 具 挑 战 性 。 

本 章 涉及 的 内 容 包 含 如 何 自动 化 验证 而 不 修改 需求 说 明 ， 如 何 控 
制 自 动 化 的 长 期 维护 成 本 ， 以 及 在 我 所 采访 的 团队 中 引起 最 多 问题 的 
两 个 方面 : 用 户 界 面 的 自动 化 与 自动 化 测试 的 数据 管理 。 文 中 描述 的 
做 法 适用 于 任何 工具 ， 所 以 我 不 会 针对 某 个 工具 展开 讨论 。 如 果 你 对 
这 个 话题 感 兴趣 ， 并 且 想 做 更 深入 的 研究 ， 请 查阅 
http://specificationbyexample.com 并 下 载 相 关 文 章 。 在 开始 之 前 ， 我 先 
回答 一 下 邮件 组 与 论坛 里 常见 的 一 个 问题 : 我 们 是 否 真 的 需要 这 种 新 
型 自动 化 ? 


由 于 自动 化 是 技术 性 很 强 的 问题 ， 所 以 本 章 将 比 其 他 章节 更 偏 技 
术 性 。 如 果 你 本 人 并 非 开 发 人 员 或 自动 化 专家 ， 那 么 你 可 能 会 觉得 某 
些 部 分 很 难 理解 。 我 建议 你 只 阅读 本 章 前 两 个 小 节 而 略 过 其 余部 分 ， 
这 样 你 也 不 会 遗漏 任何 你 感 兴 趣 的 内 容 。 

其 原理 是 什么 

所 有 最 热门 的 自动 化 可 执行 需求 说 明 的 工具 都 具有 两 种 工件 : 可 
读 形式 的 需求 说 明 与 编程 语言 中 的 自动 化 代码 。 需 求 说 明 的 格式 可 以 
是 纯 文 本 、HTMIL 或 其 他 的 可 读 格 式 ， 不 同 的 工具 略 有 区 别 。 工 具 能 
够 从 需求 说 明 中 提取 输入 与 预期 的 输出 ， 然 后 可 以 将 其 传 入 自动 化 代 
码 并 判定 结果 是 否 与 预期 相符 。 自 动 化 代码 (加 上 一 些 称 为 夹具 或 步骤 
定义 的 工具 ) 会 调用 程序 的 API、 与 数据 库 进 行 交 互 ， 或 者 通过 程序 的 
用 户 界 面 执行 操作 。 

自动 化 代码 依赖 于 需求 说 明 ， 反 过 来 需求 说 明 并 不 依赖 于 自动 化 
代码 。 这 就 是 为 什么 这 些 工具 可 以 让 我 们 进行 自动 化 验证 而 无 需 修 改 
需求 说 明 的 原因 。 

有 些 工具 需要 我 们 将 例子 存放 在 程序 代码 中 ， 并 从 中 产生 可 读 的 
需求 说 明 。 从 技术 上 讲 ， 效 果 是 一 样 的 ， 但 是 此 类 工具 却 让 那些 想 要 
编写 或 修改 需求 说 明 而 又 不 熟悉 程序 代码 的 人 望而却步 。 


9.1 非得 自 云 


今天 ， 团 队 在 实施 实例 化 需求 说 明 时 面 对 的 一 个 最 大 的 问题 ， 就 
是 可 执行 需求 说 明 的 长 期 维护 成 本 。 虽 然 用 于 自动 化 可 执行 需求 说 明 
的 工具 正在 迅速 改善 ， 但 是 在 易 维 护 性 以 及 开发 工具 的 集成 性 方面 ， 
它们 依然 与 业已 得 到 认可 的 单元 测试 工具 相去 甚 远 。 自 动 化 还 给 团队 
增加 了 额外 的 工作 。 因 此 它 经 常 引 起 一 些 讨论 ， 比 如 是 否 非得 自动 化 
不 可 ， 目 动 化 的 投入 是 否 值得 。 

反对 自动 化 的 理由 是 它 会 增加 软件 开发 与 维护 的 工作 量 ， 并 且 团 
队 对 所 做 事情 的 共识 来 自 于 举例 说 明 ， 而 非 自 动 化 。Phil cowans 指 出 
这 个 观点 忽视 了 实例 化 需求 说 明 的 长 远 利益 : 


“貌似 为 了 构建 一 个 功能 你 需要 编写 两 倍 的 代码 。 但 是 要 知道 代码 
的 行 数 或 许 并 非 开 发 过 程 的 限制 因素 ， 所 以 这 个 观点 很 傻 很 天 真 。 你 
其 实 没有 考虑 到 一 个 不 争 的 事实 : 自动 化 可 以 让 你 在 维护 已 有 功能 或 
处 理 测 试 与 开发 之 间 的 误解 方面 少 花 很 多 时 间 。>” 

对 大 型 团队 来 说 ， 自 动 化 通常 都 是 很 重要 的 ， 因 为 它 可 以 确保 我 
们 对 是 否 完成 了 某 样 东西 拥有 公正 客观 的 衡量 标准 。 对 此 ，Ian Cooper 
有 一 个 很 好 的 类 比 : 

“ 当 我 疲 乱 的 时 候 ， 刷 完 盘 子 后 就 不 想 把 它们 擦 干 。 我 想 所 有 的 盘 
子 都 刷 好 了 ， 差 不 多 就 算 做 完了 。 但 是 老婆 大 人 可 不 这 么 认为 。 对 她 
来 说 ，“ 做 完 ' 意 味 着 所 有 的 盘子 都 必须 是 干 的 并 且 摆 放 好 ， 而 且 水 槽 
也 是 干净 的 。 自 动 化 就 是 强迫 开发 人 员 要 诚实 厚道 。 他 们 不 能 只 完成 
自己 感 兴趣 的 那 部 分 工作 。>” 

就 长 期 而 言 ， 自 动 化 也 很 重要 ， 因 为 它 让 我 们 可 以 更 加 频繁 地 检 
查 更 多 的 用 例 。Pierre Veragen 说 他 们 公司 的 经 理 在 很 短 的 时 间 内 就 理 
解 了 它 的 价值 所 在 : 

“突然 之 间 ， 经 理 们 意识 到 在 一 个 测试 里 检查 的 不 只 是 两 三 个 数 
字 ， 我 们 现在 可 以 检查 20 或 30 个 乃至 更 多 的 数字 ， 而 且 还 可 以 更 容易 
地 找 出 问题 所 在 。>” 

有 些 团 队 通 过 转向 技术 工具 来 降低 自动 化 成 本 。 当 我 在 为 本 书 而 
做 采访 的 时 候 ， 有 件 事 情 令 我 感到 很 惊讶 : Jim Shore 是 敏捷 社区 的 一 
位 思想 领袖 ， 并 且 还 是 实例 化 需求 说 明 的 早期 采用 者 ， 但 由 于 成 本 他 
实际 上 放弃 了 对 可 执行 需求 说 明 进 行 自动 化 。 Shore 写 道 ， 根 据 他 的 
经 验 ， 比 起 自动 化 验证 而 不 修改 需求 说 明 ， 举 例 说 明 可 带 来 的 价值 更 


多 : 


注释 : @ 我 们 的 部 分 email 往 来 公布 在 网 上 。 请 看 
http://jamesshore.com/Blog/Alternatives-to-Acceptance-Testing.html, 
http://james-shore.com/Blog/The-Problems-WithAcceptance-Testing.html 
LA Xzhttp://gojko.net/2010/03/01/are-tools-necessary-for-acceptance-testing- 
orare-they-just-evil/。 在 这 些 文 章 的 链接 里 ， 你 也 可 以 找到 社区 其 他 成 


员 的 看 法 。 我 强烈 建议 大 家 阅读 这 些 文章 ， 特 别 是 Shore 关 于 自动 化 可 
执行 需求 说 明 蔡 代 方 案 的 讨论 。 


“我 使 用 FIT 和 其 他 敏捷 验收 测试 工具 的 体会 是 这 样 的 ， 它 们 的 成 
本 大 于 所 带 来 的 价值 。 从 实际 的 客户 和 业务 专家 那里 收集 具体 的 例子 
具有 很 大 的 价值 ， 而 使 用 诸如 FIT 之 类 的 ‘自然 语言 ' 工 具 并 不 能 带 来 多 
少 价值 。” 

根据 我 的 经 验 ， 这 种 做 法 在 短期 内 可 以 节省 时 间 ， 但 它 却 使 团队 
无 法 从 实例 化 需求 说 明 中 获得 长 远 的 利益 。 

在 决定 是 使 用 一 种 技术 工具 来 自动 化 需求 说 明 的 验证 还 是 使 用 可 
执行 需求 说 明 的 目 动 化 工具 时 ， 请 考虑 一 下 你 想 要 从 中 获得 哪 种 好 
处 。 如 果 我 们 使 用 一 种 技术 工具 来 自动 化 那些 例子 ， 那 么 自动 化 会 更 
加 容易 并 且 维护 成 本 更 低 ， 但 却 失去 了 今后 用 它们 与 商业 用 户 进 行 沟 
通 的 能 力 。 我 们 可 以 获得 很 好 的 回归 测试 ， 但 是 这 些 需 求 说 明 只 有 写 
这 些 测试 的 人 才能 看 得 懂 。 根 据 你 所 处 的 环境 ， 你 需要 判断 这 是 否 5 
以 接受 。 

自动 化 验证 而 不 修改 需求 说 明 是 建立 活 文档 的 关键 部 分 。 舍 弃 这 
部 分 ， 我 们 就 不 能 保证 可 读 的 需求 说 明 的 正确 性 。 对 于 许多 团队 来 
说 ， 实 例 化 需求 说 明 的 长 远 利益 来 自 于 活 文档 。 因 此 ， 不 要 舍弃 自动 
化 ， 它 们 会 保留 着 原始 的 需求 说 明 ， 我 们 转 而 需要 想 办 法 去 控制 维护 
成 本 。 在 本 章 稍 后 的 9.3 节 及 本 书 第 10 章 ， 你 将 看 到 很 多 团队 用 来 降低 
长 期 维护 成 本 的 好 方法 。 


9.2 从 自动 化 开始 


可 执行 需求 说 明 的 自动 化 验证 完全 不 同 于 开发 人 员 和 测试 人 员 常 
用 的 单元 测试 、 录 制 与 脚本 化 的 功能 目 动 化 。 目 动 化 的 同时 保留 可 读 
性 ， 需 要 团队 学 习 如 何 使 用 新 的 工具 并 探索 将 自动 化 契合 到 系统 中 的 
最 好 方式 。 以 下 是 关于 如 何 开始 实施 自动 化 过 程 的 一 些 好 想法 ， 以 及 
我 采访 的 团队 在 实施 自动 化 的 过 程 中 所 犯 的 常见 错误 。 


9.2.1 为 了 学 习 工 具 ， 先 党 试 一 个 简单 的 项 目 


适用 于 : 在 遗留 系统 上 工作 时 

一 些 团 队 会 利用 一 个 简单 的 项 目 或 一 个 spike 来 学 习 如 何 使 用 新 的 
自动 化 工具 。 如 果 你 的 工作 管道 中 有 相对 独立 的 一 小 部 分 工作 ， 那 么 
正好 可 以 使 用 这 种 方法 。 

~ 小 的 项 目 可 以 最 小 化 风险 ， 有 助 于 你 专注 地 学 习 如 何 使 用 工 
具 ， 而 无 需 处 理 复杂 的 集成 与 业务 规则 。 


你 先 来 ! | 


~ 


如 果 你 在 转型 到 敏捷 开发 过 程 的 同时 想 要 实施 实例 化 需求 说 明 ， 
这 种 做 法 将 会 特别 有 效 。 

在 uSwitch， 当 他 们 准备 引入 Cucumber (可 执行 需求 说 明 的 另外 一 
种 热门 自动 化 工具 ) 时 ， 他 们 就 是 采用 了 这 种 方法 。 他 们 让 整个 开发 
团队 将 原 有 的 测试 转换 到 新 的 工具 上 ， 这 使 得 团队 的 每 个 人 都 迅速 体 
验 了 一 下 新 的 工具 。Stephen Lloyd 说 同时 这 也 展示 了 可 执行 需求 说 明 
的 威力 : 


“我 们 意识 到 还 有 一 整套 其 他 级 别 的 测试 需要 完成 ， 并 且 当 前 开发 
周期 尾声 的 测试 没有 太 多 意义 。” 

利用 小 型 项 目 可 以 学 习 并 锻炼 新 的 技能 ， 而 不 会 对 正在 进行 的 开 
发 工作 带 来 多 少 风 险 ， 因 此 相 较 于 其 他 风险 更 高 的 试验 方法 ， 这 种 方 
法 更 容易 获得 批准 。 

将 结果 交 给 外 部 的 咨询 师 来 评审 或 许 是 个 不 错 的 主意 。 做 完 一 部 
分 可 以 评审 的 内 容 后 ， 外 部 咨询 师 能 够 提供 更 有 意义 的 反馈 并 讨论 出 
更 好 的 方案 。 到 那 时 ， 团 队 也 将 获得 试用 工具 并 巩固 基础 知识 的 机 
会 ， 这 样 他 们 就 能 理解 更 先进 的 技术 并 从 咨询 师 那 里 获得 更 多 的 价 
值 。 

9.2.2 事先 计划 自动 化 

在 那些 没有 事先 设计 好 自动 化 测试 的 系统 上 工作 时 ， 他 们 在 自动 
化 可 执行 需求 说 明 的 初期 ， 生 产 力 会 下 降 。 

即使 不 考虑 学 习 使 用 新 工具 所 带 来 的 消耗 ， 自 动 化 验证 在 初期 还 
是 会 给 项 目 增加 显著 的 开销 。 自 动 化 需要 有 前 期 准备 ， 开 始 自动 化 之 
前 有 大 量 的 工作 必须 完成 ， 包 括 创建 基础 的 自动 化 组 件 、 确 定 可 执行 
需求 说 明 的 最 佳 格式 及 与 系统 集成 的 最 佳 方式 、 解 决 测试 稳定 性 与 专 
用 环境 的 问题 以 及 其 他 诸多 事项 。 大 多 数 此 类 问题 我 们 将 在 本 章 与 第 
10 章 涉及 ， 但 现在 重要 的 是 需要 了 人 解 生产 效率 在 自动 化 初期 会 有 所 下 
降 。 

一 旦 解决 了 这 些 问 题 并 且 可 执行 需求 说 明 的 结构 稳定 之 后 ， 我 们 
就 可 以 在 新 的 需求 说 明 里 重用 自动 化 的 基础 组 件 。 当 项 目 成 熟 后 ， 自 
动 化 所 需 的 工作 量 将 会 显著 降低 ， 而 生产 效率 将 极速 提升 。 

在 有 些 项 目 中 ， 开 发 人 员 在 预 估 实 现 一 个 故事 所 需 的 工作 量 时 ， 
并 没有 考虑 到 上 面 提 到 的 这 个 问题 。 因 而 在 开始 进行 自动 化 时 ， 他 们 
突然 发 现 花费 在 自动 化 可 执行 需求 说 明 上 的 时 间 可 能 就 要 比 在 生产 代 
码 中 实现 相关 功能 所 需 的 时 间 多 得 多 。 

-确保 事先 为 生产 率 降低 做 好 了 计划 。 为 了 在 当前 迭代 内 完成 自 
动 化 ， 团 队 必须 减少 交付 内 容 。 


除非 做 过 此 类 计划 ， 否 则 自动 化 将 会 蔓延 到 下 一 轮 和 迭代 并 且 中 断 
流程 。 这 是 Pyxis 技 术 公 司 Talia 产 品 的 总 监 André Brissette 得 到 的 一 个 重 
要 教训 : 

“如 果 可 以 重新 来 过 ， 我 会 在 一 开始 就 更 明确 地 指出 编写 测试 〈 可 
执行 需求 说 明 ) 的 必要 性 。 我 当时 知道 对 团队 来 说 编写 这 种 测试 是 一 
种 挑战 ， 所 以 我 也 是 很 有 耐心 。 但 我 本 应 该 在 sprint (迭代 ) BA 
写 测 试 腾 出 更 多 时 间 。 当 时 开始 之 后 ， 我 们 谈 到 可 执行 需求 说 明 时 ， 
团队 说 : ‘我 们 真 的 没有 时 间 来 跨 过 这 道学 习 门 榄 ， 因 为 我 们 这 个 
sprint 的 工作 已 经 排 满 了 7。; 事 实 上 ， 他 们 工作 负载 大 的 一 个 原因 是 我 
在 该 sprint 里 放 入 了 大 量 需要 完成 的 功能 。 因 此 ， 自 动 化 启动 起 来 很 
慢 ， 并 且 经 过 了 很 多 轮 迭 代 才 有 了 一 组 像样 的 需求 说 明 。 

如 果 一 开始 就 攻破 这 道 屏障 ， 并 在 初期 只 实现 较 少 的 功能 ， 或 许 
会 更 加 有 效 。 下 一 次 我 会 选择 这 么 做 。 如 果 你 长 期 采取 这 种 混杂 的 方 
式 ， 你 得 到 的 只 有 成 本 增加 而 不 会 有 所 收益 ， 代 价 反 而 更 加 昂贵 。” 

为 了 确保 在 计划 中 包含 局 动 自动 化 的 工作 量 ， 有 一 个 方法 是 将 自 
动 化 工具 库 当 作 单 独 的 产品 来 开发 ， 使 其 拥有 自己 的 功能 清单 ， 然 后 
团队 把 一 定 比例 的 时 间 用 在 该 产品 上 。 为 了 清晰 起 抑 ， 主 要 产品 和 上 自 
动 化 框架 应 该 由 同一 个 团队 来 开发 和 交付 ， 这 样 团队 就 能 熟悉 此 后 要 
做 的 自动 化 。 我 建议 完全 将 它 看 作 是 一 个 单独 的 产品 ， 以 便 减 少 对 主 
要 交付 工作 的 影响 。 


9.2.3 aY LE à 


由 于 目 动 化 所 需 的 开销 ， 有 些 团队 推迟 了 目 动 化 。 他 们 使 用 例子 
省 述 了 需求 说 明 ， 然 后 编写 了 代码 ， 却 将 自动 化 推迟 进行 。 那 些 开 发 
团队 和 测试 目 动 化 团队 是 独立 的 项 目 ， 或 者 自动 化 测试 是 由 外 部 咨询 
师 编写 的 项 目 似乎 更 容易 出 现 这 种 情况 。 无 论 如 何 ， 这 会 导致 大 量 的 
返工 与 来 回 折腾 。 

开发 人 员 把 用 户 故 事 标 识 为 已 完成 ， 却 没有 一 个 客观 的 自动 化 标 
准 与 其 相对 应 。 最 终 将 验收 测试 自动 化 时 ， 往 往 暴露 出 不 少 问 题 ， 这 
些 用 户 故 事 也 不 得 不 再 回 到 开发 人 员 手 里 进行 修复 。 


当 自 动 化 与 开发 同时 进行 时 ， 开 发 人 员 必 须 将 系统 设计 得 容易 测 
试 。 而 当 自动 化 委派 给 测试 人 员 或 外 部 咨询 师 时 ， 开 发 人 员 就 不 会 去 
关心 如 何 让 系统 容易 被 验证 。 这 使 得 自动 化 更 难 、 人 花费 更 高 。 当 自动 
化 出 现 问题 时 ， 还 会 导致 测试 拖延 到 下 一 个 迭代 并 打 乱 流程 。 

-不 要 因为 可 执行 需求 说 明 的 开销 问题 而 推迟 自动 化 ， 只 有 积极 
加 以 处 理 ， 后 续 的 事情 才 会 轻松 一 些 。 

推迟 自动 化 仅仅 是 个 权宜 之 计 。 对 于 早期 的 开发 进度 来 说 ， 它 可 
能 会 加 快 交 付 用 户 故 事 的 速度 ， 但 是 那些 用 户 故 事 今 后 还 是 会 再 次 回 
来 要 求 修 复 的 。 对 此 ，David Evans 经 常用 公交 车 做 比喻 : 如 果 公 交 车 
不 用 为 了 上 客 而 停车 ， 那 么 它 可 以 开 得 快 很 多 ; 但 这 么 一 来 ， 它 就 根 
本 不 能 发 挥 作用 了 。 


— i a= Ps 
IR BAS 


9.2.4 wr Foti tao BYE) EH 


开始 时 根据 原 有 的 手动 测试 脚本 来 创建 可 执行 的 需求 说 明 貌 似 是 
合乎 情理 的 做 法 。 此 类 脚本 已 经 描述 了 系统 的 行为 ， 并 且 测 试 人 员 也 
在 使 用 ， 所 以 用 来 进行 目 动 化 必定 会 有 所 帮助 。 但 真是 这 样 的 吗 ? 事 
实 并 非 如 此 ， 这 恰恰 是 最 常见 的 一 种 失败 模式 。 

手动 检验 与 自动 化 校 验 的 约束 条 件 是 完全 不 一 样 的 。 在 手动 测试 
中 ， 准 备 上 下 文 环境 所 花 的 时 间 往 往 是 主要 的 瓶颈 所 在 。 而 在 自动 化 
测试 中 ， 时 间 主 要 化 在 了 寻找 测试 失败 的 原因 上 。 

例如 ， 为 了 准备 测试 用 户 账户 管理 的 逻辑 ， 测 试 人 员 可 能 必须 先 
登录 到 管理 端 程序 ， 创 建 一 个 用 户 ， 然 后 用 新 创建 的 用 户 登录 客户 站 
程序 并 更 改 其 密码 。 为 了 避免 在 测试 中 重复 以 上 步骤 ， 测 试 人 员 会 在 
多 个 手动 测试 脚本 中 重用 这 样 的 测试 上 下 文 环境 。 这 样 只 需 创建 一 个 
用 户 ， 就 可 以 进行 多 个 测试 ， 比 如 屏 贡 该 账户 并 验证 用 户 无 法 登录 ， 
而 后 重 置 密码 并 验证 相应 功能 ， 再 然后 更 改 用 户 偏好 设置 并 验证 其 首 
页 的 变化 。 这 种 方式 有 助 于 测试 人 员 更 快 地 执行 手动 测试 脚本 。 

而 在 自动 化 测试 中 ,创建 并 设 定 用 户 所 花 的 时 间 不 再 是 个 间 题 。 
通 驯 ， 目 动 化 测试 可 以 比 手动 测试 执行 更 多 用 例 。 当 目 动 化 测试 运行 
正常 时 ， 没 人 会 去 查看 它们 。 一 旦 测试 出 现 失败 ， 则 必须 有 人 去 找 出 


问题 所 在 。 如 果 测试 描述 的 是 一 系列 相互 依赖 的 步骤 ， 那 么 由 于 脚本 
中 的 上 下 文 在 不 停 地 变化 ， 我 们 会 很 难 理解 究 竞 是 什么 导致 了 问题 。 

相对 于 较 小 并 且 更 专注 的 测试 ， 在 单一 脚本 中 检查 10 件 不 同 的 事 
情 比较 容易 出 错 ， 因 为 不 同 领域 的 代码 会 影响 它 的 结果 。 在 之 前 的 用 
户 账户 管理 的 例子 中 ， 如 果 密 码 重 置 功 能 有 问题 ， 那 么 设置 用 户 偏好 
也 将 无 法 进行 。 结 果 导 致 检查 用 户 首页 变化 的 验证 也 将 失败 。 如 果 我 
们 不 去 使 用 一 个 较 大 的 脚本 ， 转 而 用 10 个 较 小 的 、 专 注 的 并 且 独 立 的 
测试 ， 那 么 密码 重 置 功能 中 的 Bug 不 会 影响 用 户 偏好 的 测试 结果 。 这 
让 测试 更 具 弹 性 并 且 可 以 降低 维护 成 本 ， 同 时 也 有 助 于 更 快 地 找 出 问 
题 。 

~ 不 要 直接 将 手动 测试 脚本 自动 化 ， 要 考虑 脚本 的 测试 目的 ， 并 
使 用 一 组 独立 的 、 专 注 的 测试 来 描述 测试 目的 ， 这 会 显著 降低 自动 化 
的 开销 与 维护 成 本 。 


9.2.5 通过 疯 | 


适用 于 : 团队 成 员 怀 疑 可 执行 的 需求 说 明 时 

许多 用 于 自动 化 可 执行 需求 说 明 的 工具 允许 我 们 在 用 户 界 面 层 之 
下 与 软件 进行 整合 。 这 可 以 降低 维护 成 本 、 让 实现 自动 化 变 得 更 加 容 
易 ， 并 且 可 以 提供 快速 反馈 (请 参考 本 章 后 面 9.3.6 节 的 内 容 ) 。 

但 是 商业 用 己 与 测试 入 员 一 开始 可 能 不 会 信任 此 类 目 动 化 测试 。 
他 们 在 屏幕 上 看 不 到 变化 ， 就 不 会 相信 代码 正在 被 验证 。 

= 刚 开始 使 用 实例 化 需求 说 明 时 ， 如 果 团队 成 员 质 疑 自动 化 的 必 
要 性 ， 那 么 你 们 可 以 尝试 通过 用 户 界面 来 执行 需求 说 明 。 请 注意 ,不 
要 去 修改 需求 说 明 以 描述 用 户 界面 的 交互 ， 但 是 你 可 以 在 自动 化 层 里 
隐藏 这 些 动作 。 

在 挪威 的 奶牛 记录 系统 项 目 中 ， 获 得 商业 用 户 对 可 执行 需求 说 明 
的 信任 是 一 个 艰巨 的 任务 。 来 自 Bekk 咨 询 公 司 的 经 理 Berge Lotre 参 与 
了 这 个 项 目 ， 他 说 随 着 可 执行 需求 说 明 中 检验 的 增多 ， 他 们 逐渐 地 赢 
得 了 信任 : 


“他 们 (商业 用 户 ) 以 前 坚持 要 求 除了 Cucumber 测 试 ， 还 需要 有 
手动 测试 。 我 认为 他 们 正 逐 渐 看 到 Cucumber 测 试 的 价值 ， 因 为 他 们 
无 法 在 我 们 每 次 增加 新 的 功能 时 都 执行 (手动) 测试 来 验证 已 有 的 功 
能 。 ý 

因为 用 户 界 面 自动 化 会 减 慢 反馈 速度 ， 并 且 会 显著 增加 自动 化 层 
的 复杂 度 ， 所 以 通过 界面 自动 化 可 执行 需求 说 明 通 常 应 该 是 不 得 已 而 
为 之 的 。 反 过 来 说 ， 通 过 用 户 界面 执行 自动 化 的 需求 说 明 可 能 是 刚 开 
始 获 得 非 技术 性 用 户 信任 的 好 方法 。 要 让 自动 化 层 具 有 一 定 的 灵活 
性 ， 这 样 以 后 可 以 切换 到 应 用 程序 的 界面 层 之 下 与 系统 进行 集成 。 

当 遗 留 系统 没有 清晰 地 集成 API 时 (这 种 情况 下 ， 自 动 化 测试 的 
唯一 方法 是 端 到 端 ， 从 前 端 用 户 界 面 开 始 ， 在 数据 库 中 或 再 次 利用 用 
户 界面 来 验证 结果 ) ， 那 么 通过 用 户 界 面 来 运行 可 执行 的 需求 说 明 也 
是 一 个 不 错 的 选择 。 在 这 种 情况 下 ， 让 自动 化 层 具 有 一 定 的 弹性 同样 
是 一 个 不 错 的 主意 ， 因 为 一 旦 架构 变 得 更 具 可 测 性 ， 你 很 可 能 会 将 它 
们 转移 到 用 户 界 面 层 之 下 进行 自动 化 。 

除了 赢得 信任 ， 有 时 候 在 自动 化 测试 过 程 中 看 到 应 用 程序 界面 ， 
也 会 有 助 于 大 家 想到 一 些 其 他 的 例子 。 

根据 本 人 的 经 验 以 及 为 编写 本 书 所 做 的 案例 分 析 ， 通 过 用 户 界面 
执行 测试 不 易 扩 展 。 在 赢得 利益 相关 者 的 信任 之 后 ， 你 可 能 会 想 要 减 
少 通过 用 户 界 面 执行 的 测试 。 

如 果 你 决定 要 通过 用 户 界面 来 自动 化 需求 说 明 ， 那 么 请 应 用 本 章 
后 面 9.4 节 所 描述 的 想法 ， 以 便 充 分 利用 其 价值 并 确保 在 必要 时 可 以 将 
自动 化 测试 转移 到 用 户 界面 层 之 下 。 


9.3 Z 


我 采访 的 那些 团队 长 期 面 对 的 一 个 最 大 挑战 是 控制 活 文 档 系统 的 
维护 成 本 。 其 中 一 个 主要 的 因素 是 有 效 地 管理 自动 化 。 

本 市 中 ， 我 将 介绍 一 些 团队 用 来 降低 目 动 化 层 长 期 维护 成 本 的 一 
些 好 想法 。 本 节 的 建议 适用 于 各 种 自动 化 工具 。 


9.3.1 J! a 二 等 公 


团队 经 常会 犯 的 错误 是 ， 认 为 需求 说 明 或 相关 的 自动 化 代码 没有 
生产 代码 重要 。 将 编写 自动 化 测试 的 任务 交 给 能 力 较 差 的 开发 人 员 和 与 
测试 人 员 就 是 证 据 ， 同 时 也 没有 投入 像 生 产 代 码 那么 多 的 精力 来 维护 
自动 化 层 。 

很 多 情况 下 ， 这 种 认识 来 自 于 一 种 误解 ， 那 就 是 实例 化 需求 说 明 
仅仅 是 功能 测试 的 自动 化 〈 也 就 是 敏捷 验收 测试 和 验收 测试 驱动 开 
发 ) ， 同 时 开发 人 员 认 为 测试 代码 没 那 么 重要 。 

Wes Williams 说 这 使 他 想起 了 早期 使 用 单元 测试 工具 的 经 验 : 

“我 想 这 与 编写 JUnit 有 类 似 的 学 习 曲 线 。 一 开始 我 们 对 JUnit 测 试 
采取 了 同样 的 态度 ， 接 下 来 每 个 人 都 参与 到 测试 编写 中 ，“ 了 ! 伙计 
们 ，JUnit 也 是 代码 ， 也 应 该 要 整洁 清晰 '。 如 果 不 这 么 做 就 会 磁 到 维 
护 性 问题 。 后 来 我 们 了 解 到 测试 页 面 (可 执行 的 需求 说 明 ) 本 身 也 
是 ‘代码 '?。” 


Phil cowans 将 这 个 问题 列 为 他 的 团队 早期 在 Songkick 实 施 实 例 化 
需求 说 明 时 所 犯 的 一 个 最 大 的 错误 。 他 说 : 

“测试 代码 与 应 用 程序 的 常规 代码 一 样 也 是 一 等 公民 ， 也 需要 维 
护 。 我 现在 甚至 认为 (验收 ) 测试 是 一 等 的 ， 而 (生产) 代码 本 身 则 
不 如 它 重要 ， 因 为 测试 是 对 应 用 程序 能 做 什么 事情 的 权威 描述 。 

归根 结 底 ， 要 取得 成 功 ， 更 多 的 是 要 解决 如 何 构建 正确 的 东西 ， 
而 不 是 正确 地 构建 。 如 果 测 试 描述 的 是 代码 具有 的 功能 ， 那 么 它 不 仅 
仅 是 开发 过 程 中 非常 重要 的 一 部 分 ， 而 且 它 对 于 构建 产品 、 理 解构 建 
内 容 并 保持 复杂 度 可 控 也 是 非常 重要 的 一 部 分 。 当 时 我 们 大 概 花 了 一 
年 时 间 才 意识 到 这 一 点 。” 

Clare McLennan 指 出 ， 让 最 有 能 力 的 人 去 设计 和 构建 自动 化 层 是 
非常 天 键 的 : 

“有 一 天 我 回去 后 ， 某 个 开发 人 员 说 测试 集成 框架 的 设计 几乎 比 实 
际 产 品 的 设计 还 重要 。 也 就 是 说 ， 测 试 框架 需要 拥有 与 实际 产品 一 样 
好 的 设计 ， 因 为 它 必须 是 可 维护 的 。 测 试 系 统 之 所 以 能 成 功 的 部 分 原 
因 是 ， 我 们 了 解 到 它 的 结构 并 且 可 以 读 懂 它 的 代码 。 

项 目 中 他 们 往往 会 让 初级 程序 员 编写 测试 代码 与 测试 系统 。 然 
而 ， 自 动 化 的 测试 系统 是 很 难 设计 好 的 。 初 级 程序 员 往 往 会 选择 错误 
的 方法 ， 而 且 他 们 构建 的 东西 也 不 大 可 靠 。 所 以 请 用 最 好 的 架构 师 来 
做 这 件 事情 。 他 们 要 有 能 力 说 出 这 样 的 话 : 如 果 我 们 要 在 设计 中 修改 
这 个 ， 那 么 它 会 好 很 多 并 且 更 容易 测试 。” 

我 还 不 至 于 认为 自动 化 代码 比 生 产 代码 重要 。 归 根 结 底 ， 构 建 软 
件 的 目的 是 因 生 产 代 码 可 以 帮助 我 们 达成 一 些 商 业 目 标 。 如 果 没 有 很 
好 的 生产 代码 ， 那 么 即使 是 世界 上 最 好 的 自动 化 框架 也 无 法 让 项 目 取 
得 成 功 。 

- 带 实例 的 需求 说 明 (最 终 以 活 文档 形式 存在 ) 比 生 产 代码 存活 
得 久 得 多 。 当 我 们 使 用 更 好 的 技术 完全 重 写生 产 代码 时 ， 良 好 的 活 文 
档 系 统 是 至 关 重 要 的 。 它 比 任何 代码 都 经 久 耐 豪 。 


9.3.2 动 化 技 证 过 


目 动 化 可 执行 需求 说 明 的 工具 大 多 使 用 纯 文本 或 HTML 格 式 来 处 
理 需 求 说 明 。 这 让 我 们 在 更 改 需求 说 明 时 无 需 重新 编译 或 重新 部 署 程 
序 代码 。 另 一 方面 ， 自 动 化 层 是 程序 代码 ， 修 改 后 需要 重新 编译 与 重 
新 部 署 。 

为 了 避免 频繁 修改 ， 许 多 团队 尝试 让 目 动 化 层 具 有 通用 性 。 他 们 
在 自动 化 层 中 只 创建 低层 次 级 别 的 可 重用 组 件 ， 比 如 UI 自动 化 命令 ， 
然后 使 用 这 些 命令 将 验证 过 程 脚本 化 ， 比 如 用 这 些 命 令 来 验证 网 站 的 
工作 流 。 这 种 做 法 的 一 个 明显 标志 是 ， 需 求 说 明 中 包含 了 用 户 界面 的 
概念 《比如 点 击 链接 或 者 打开 窗口 ) ， 或 者 更 有 甚 者， 在 需求 说 明 中 
包含 了 更 低级 别 的 自动 化 命令 (例如 Selenium) 的 操作 。 

例如 ，Ultimate 软 件 公 司 的 Global Talent Management 团 队 决 定 在 某 
个 时 候 将 所 有 工作 流 剥离 自 动 化 层 并 将 其 放 入 到 测试 需求 说 明 中 。 他 
们 使 用 了 自己 定制 的 开源 UI 自动 化 工具 SWAT， 以 便 将 所 有 SWAT 命 令 
直接 暴露 为 fixture。 他 们 将 SWAT 命 令 组 成 具有 意义 的 领域 工作 流 供需 
求 说 明 使 用 。 这 种 方式 最 初 使 得 编写 需求 说 明 更 为 简单 ， 但 后 来 导致 
了 许多 维护 问题 ，Scott Berger 和 Maykel Suarez 说 : 

“有 一 个 中 心 团队 专门 维护 SWAT 并 编写 宏 ， 到 了 某 个 时 刻 已 经 无 
法 维护 了 。 我 们 使 用 了 基于 宏 的 宏 ， 这 样 导致 了 难以 重 构 (测试 ) ， 
所 有 一 切 都 成 了 一 场 亚 梦 。 一 个 given (测试 上 下 文 ) RESO 
区 域 ， 展 开 后 又 有 不 计 其 数 的 内 容 。 最 后 我 们 转 而 在 fixture 中 实现 工 
作 流 。 针 对 每 一 页 (需求 说 明 ) 背后 都 有 一 个 fixture 与 之 相对 应 。” 

-不 要 在 需求 说 明 里 描述 验证 过 程 ， 而 应 该 将 它们 放 到 自动 化 层 
里 去 记录 。 最 终 的 需求 说 明 会 更 加 专注 并 且 更 容易 理解 。 

在 自动 化 层 里 描述 验证 过 程 (相对 于 测试 “什么 ”而 言 ， 也 就 是 “如 
何 ” 测 试 ) 会 让 该 层 更 复杂 并 且 更 难 维护 ， 而 IDE 之 类 的 编程 工具 可 以 
使 这 项 任务 简单 化 。 当 Berger 的 团队 在 纯 文本 的 需求 说 明 中 将 工作 流 
首 述 为 可 重用 的 组 件 时 ， 虽 然 他 们 使 用 的 是 纯 文本 编程 ， 却 没有 任何 
开发 工具 的 支持 。 


我 们 可 以 使 用 编程 工具 来 维护 验证 过 程 的 代码 实现 ， 这 比 维护 纯 
文本 的 描述 更 加 有 效 。 我 们 还 可 以 更 容易 地 在 其 他 相关 的 需求 说 明 中 
重用 自动 化 验证 过 程 。 关 于 这 方面 的 更 多 详细 内 容 ， 请 参考 本 章 9.4.3 


= 在 自动 化 层 里 模仿 应 用 程序 的 部 分 业务 流 或 逻辑 可 以 使 得 测试 
更 容易 自动 化 ， 但 是 它 会 让 自动 化 层 更 加 复杂 化 并 且 更 难 维护 。 更 精 
糕 的 是 ， 它 会 让 测试 结果 不 太 可 靠 。 

如 果实 际 的 产品 流程 具有 某 个 问题 ， 而 这 个 问题 并 没有 复制 到 自 
动 化 层 的 流程 副本 当中 。 那 么 依赖 于 该 流程 的 某 个 实例 ， 在 真实 系统 
上 执行 时 将 会 失败 ， 而 自动 化 的 测试 却 会 执行 通过 。 这 无 疑 会 给 团队 
一 种 虚假 的 保证 ， 让 大 家 以 为 一 切 正常 。 

对 于 爱 答 华 州 助 学 贷款 公司 的 Tim Andersen 来 说 ， 这 是 一 个 最 重 
要 的 早期 经 验 : 

“我 们 并 不 使 用 测试 辅助 代码 创建 一 个 “ 伪 贷 款 '， 而 是 更 改 了 测试 
代码 以 利用 应 用 程序 来 建立 一 个 有 效 状态 的 贷款 。 后 来 ， 我 们 的 测试 
抽象 层 使 用 虚构 人 物 来 调用 应 用 程序 ， 我 们 得 以 删除 了 近 三 分 之 一 的 
(自动 化 层 ) 测试 代码 。 这 里 得 到 的 经 验 是 不 要 伪造 状态 ， 虚 幻 的 状 
态 容易 导致 缺陷 并 且 维护 成 本 更 高 。 当 我 们 使 用 真实 的 系统 来 创建 状 
态 后 ， 大 量 的 测试 失败 了 。 我 们 仔细 做 了 检查 ， 发 现 使 用 了 这 种 新 的 
方法 后 原 有 的 测试 暴露 了 系统 的 一 些 缺 陷 。” 

对 于 遗留 系统 ， 在 目 动 化 测试 中 使 用 生产 代码 有 时 候 会 导致 非常 
严重 的 问题 。 例 如 ， 我 的 一 个 客户 扩展 了 一 个 第 三 方 的 产品 ， 那 个 产 
品 的 业务 逻辑 混合 了 用 户 界 面 的 代码 ， 让 人 无 从 下 手 。 我 的 客户 对 第 
三 方 组 件 的 代码 只 有 只 读 权 限 。 有 人 起 初 直接 将 第 三 方程 序 的 部 分 代 
码 复制 到 了 测试 fixture 中 ， 并 且 删 除了 所 有 对 用 户 界 面 的 调用 。 结 果 
当 第 三 方程 序 提 供 商 更 改 了 他 们 的 代码 之 后 ， 问 题 就 出 现 了 。 

我 重 写 了 这 些 fixture， 初 始 化 第 三 方程 序 的 窗口 类 并 使 用 反射 调 
用 私有 变量 以 便 跑 通 真实 的 业务 工作 流 。 我 从 未 在 生产 代码 中 做 过 类 


似 的 事情 ， 这 只 是 两 害 相 权 取 其 轻 。 我 们 删除 了 90% 的 fixture 代 码 ， 在 
第 三 方程 序 提供 商 更 改 私 有 变量 的 用 法 后 我 们 也 必须 偶尔 修改 自动 化 
测试 ， 但 是 这 种 做 法 的 工作 量 远 远 少 于 那 种 无 时 无 刻 都 要 复制 并 修改 
大 量 代 码 的 做 法 ， 而 且 还 让 测试 具备 了 可 靠 性 。 


适用 于 : 复杂 的 集成 环境 

-如果 你 工作 于 一 个 错综复杂 的 系统 ， 那 么 理解 自己 的 职责 边界 
所 在 是 很 重要 的 。 请 沿 着 这 些 边 界 说 明 需 求 并 自动 化 测试 。 

对 于 错综复杂 的 系统 来 说 ， 可 能 很 难 甚至 无 法 在 一 个 自动 化 测试 
里 包含 整个 端 到 端的 流程 。 当 我 采访 rob Park 时 ， 他 的 团队 正在 集成 一 
个 将 语音 转换 成 数据 的 外 部 系统 。 要 让 每 个 自动 化 用 例 都 走 完整 的 流 
程 ， 即 使 有 可 能 ， 也 是 不 切实 际 的 。 他 们 并 不 是 在 开发 语音 识别 程 
序 ， 只 是 与 这 样 的 系统 进行 集成 而 已 。 

他 们 的 职责 在 于 在 语音 信息 转换 成 数据 后 对 其 进行 处 理 。Park 说 
他 们 决定 隔离 这 个 系统 并 提供 一 个 替代 的 输入 途径 以 便 更 容易 进行 自 
动 化 : 

“我 们 正在 为 互动 式 语音 应 答 (IVR) 编写 一 个 功能 。 策 略 编号 与 
鉴定 信息 会 自动 从 IVR 系统 传输 到 该 应 用 程序 中 ， 因 此 界面 上 会 带 有 
预 填充 值 。 在 进行 了 第 一 次 “神勇 三 剑客 ”会 议 后 ， 结 论 很 明显 ， 那 就 
是 我 们 需要 一 个 测试 页 面 来 准备 IVR 发 出 的 数据 。” 

Park 的 团队 并 没有 把 外 部 系统 包含 进去 ， 将 那些 例子 进行 端 到 端 
的 自动 化 ， 他 们 将 外 部 输入 从 系统 中 解 耦 出 来 ， 并 且 将 系统 中 他 们 负 
责 的 那 部 分 验证 进行 了 自动 化 。 这 让 他 们 能 够 使 用 可 执行 的 需求 说 明 
来 验证 所 有 重要 的 业务 规则 。 


商业 用 户 很 自然 地 会 考虑 端 到 端的 验收 。 他 们 对 没有 包含 外 部 系 
统 的 自动 化 测试 感到 没有 信心 。 这 个 问题 应 该 交 给 单独 的 技术 性 集成 
测试 去 处 理 。 在 这 个 案例 中 ， 播 放 一 个 简单 的 预 录制 信息 并 验证 它 是 
否 完整 经 过 系统 就 是 诀 窒 所 在 。 这 个 测试 将 会 验证 所 有 组 件 相 互 之 间 
是 否 能 够 正确 地 对 话 。 因 为 所 有 业务 规则 都 单独 说 明 并 测试 了 ， 所 以 
我 们 无 需 为 所 有 重要 的 用 例 都 运行 高 层次 的 集成 测试 。 

关于 如 何 处 理 大 型 的 、 复 杂 的 基础 设施 还 有 更 多 技巧 ， 请 参考 下 


多 数 可 执行 需求 说 明 的 自动 化 工具 则 可 以 在 用 户 界面 之 下 直接 与 应 用 
程序 编程 接口 (APT) 交 互 。 

-除非 通过 用 户 界 面 端 到 端 地 运行 某 个 功能 的 自动 化 需求 说 明 是 
信任 该 功能 的 唯一 途径 ， 否 则 请 不 要 这 么 做 。 

用 户 界 面 自动 化 通常 比 在 服务 层 或 API 层 级 的 自动 化 更 慢 并 且 维 
护 成 本 更 高 。 通 过 自动 化 可 视 的 用 户 界 面 来 赢得 信任 (如 本 章 前 面 所 


述 ) 是 一 个 特例 ， 只 要 条 件 允 许 ， 在 用 户 界面 层 之 下 验证 业务 逻辑 往 
往 是 更 好 的 方案 。 
9.3.6 Ev. 


适用 于 : 检查 session 约 束 与 工作 流 约束 

通常 工作 流 与 session 的 规则 只 能 通过 用 户 界面 层 来 做 检查 ， 但 这 
并 不 意味 着 自动 化 此 类 检查 的 唯一 途径 就 是 打开 浏览 器 。 有 几 个 开发 
Web 应 用 程序 的 团队 没有 通过 浏览 器 来 自动 化 需求 说 明 ， 他 们 直接 利 
用 HTTP 层 (就 在 应 用 程序 表皮 之 下 ) 进行 自动 化 ， 这 节省 了 大 量 的 时 
间 和 精力 。Tim Andersen 是 这 么 诠释 这 种 方法 的 : 

“我 们 会 发 送 一 个 很 像 HTTP 请 求 的 哈 希 表 。 它 具有 一 些 默 认 值 ， 
我 们 会 改写 其 中 某 些 对 测试 比较 重要 的 数据 ， 测 试 所 做 的 事情 与 
HTTP 请 求 所 做 的 大 同 小 异 。 这 就 是 我 们 的 虚拟 人 物 [fixture] 的 工作 
原理 : 使 用 对 象 来 发 送 HTTP 请 求 。 它 们 就 是 这 样 使 用 真实 的 状态 和 
对 象 的 。” 

不 去 运行 浏览 器 ， 可 以 让 自动 化 的 检验 并 行 执行 而 且 运 行 得 更 
快 。 而 Christian Hassa 使 用 了 一 种 类 似 的 但 更 底层 的 方法 : 调用 应 用 程 
序 内 部 的 web 控制 器 。 这 样 不 仅 避 免 了 HTTP 调 用 而 且 还 加 快 了 反馈 速 
度 。 他 是 这 么 解释 的 : 

“我 们 将 一 部 分 (需求 说 明 ) 通过 Selenium 直接 绑 定 在 UI 上 ， 而 
将 其 余部 分 直接 绑 定 到 MVC 的 控制 器 上 。 直 接 绑 定 到 UI 的 开销 是 很 大 
的 ， 而 且 我 觉得 这 也 不 是 这 种 技术 的 主要 价值 所 在 。 如 果 让 我 选择 是 
将 需求 说 明 全 部 绑 定 到 控制 器 ， 还 是 将 有 限 的 一 部 分 绑 定 到 UI， 我 一 
定 会 选择 前 者 。 是 否 绑 定 到 UI 对 我 而 言 是 个 可 选项 ， 不 把 所 有 与 系统 
有 关 的 需求 说 明 都 绑 定 到 控制 器 上 则 不 是 个 可 选项 ， 况 且 绑 定 到 UI 的 
成 本 高 得 多 。” 


s= = 
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+ 在 应 用 程序 的 表皮 之 下 进行 自动 化 是 一 种 很 好 的 方法 ， 这 样 既 
可 以 重用 实际 的 业务 流程 ， 也 可 以 避免 在 自动 化 层 里 出 现 重复 。 通 过 
直接 调用 HTTP 而 不 是 通过 浏览 器 来 执行 检查 ， 可 以 让 验证 速度 显著 
加 快 并 且 使 执行 并 行 检查 成 为 可 能 。 

浏览 器 自动 化 程序 库 通常 很 慢 而 且 会 锁定 用 户 配置 ， 所 以 一 台 机 
器 上 只 能 同时 运行 一 个 此 类 检查 。 直 接 调 用 HTTP 的 自动 化 工具 和 程序 
库 有 很 多 ， 比 如 WebRatD . Twill? 以 及 Selenium 2.0 HtmlUnit Driver® 
。 很 多 新 颖 的 MVC 框 架 支持 在 HTTP 层 之 下 进行 自动 化 ， 这 可 以 让 此 
类 检查 更 加 高 效 。 这 些 工 具 人 允许 我 们 并 行 执行 测试 ， 因 为 它们 动用 的 
部 件 比 浏览 器 自动 化 要 少 ， 所 以 更 快 而 且 更 可 靠 。 


注释 : (Dhttp://wiki.github.com/brynary/webrat 
注释 : @http://twill.idyll.org 


注释 : © http://seleniumhq.org/docs/03_webdriver.html#htmlunit- 
driver 


选择 自动 化 哪些 东西 


在 Bridging the communication Gap 一 书 中 ， 我 建议 自动 化 所 有 需 
求 说 明 。 在 准备 此 书 的 过 程 中 ， 当 我 与 许多 不 同 的 团队 进行 交谈 后 ， 


我 了 解 到 有 些 情况 下 自动 化 是 不 值得 的 。Gaspar Nagy 给 了 我 两 个 很 
好 的 例子 : 

“与 验收 条 件 所 带 来 的 利益 相 比 较 ， 有 了 时 自动 化 成 本 会 过 高 ， 例 
如 ， 将 内 容 显 示 在 一 个 可 排序 的 表格 内 。 用 户 界面 控件 (widgeb 本 身 就 
支持 排序 功能 。 为 了 检查 数据 是 否 真 的 被 排序 了 ， 你 需要 大 量 边界 案 
例 的 测试 数据 。 这 最 好 还 是 留 给 比较 快速 的 手动 检查 去 做 。 

我 们 的 应 用 程序 还 需要 离线 功能 。 非 常 特殊 的 离线 边界 案例 可 能 
会 很 难 自动 化 ， 同 时 手动 测试 或 许 已 经 足够 好 了 。>” 

在 以 上 两 个 例子 中 ， 快 速 的 手动 检查 就 可 以 让 团队 对 系统 产生 一 
定 的 信心 : 我 们 的 系统 是 用 户 可 以 接受 的 。 自 动 化 所 需 的 时 间 会 多 于 
长 期 来 看 节省 的 时 间 。 

多 数 情况 下 ， 对 检查 布局 的 实例 进行 自动 化 并 非 一 个 好 的 做 法 。 
这 样 做 技术 上 是 可 行 的 ， 但 是 这 对 许多 团队 来 说 都 会 是 高 投入 低产 出 
的 。 对 参照 实用 性 的 例子 进行 自动 化 (比如 7.6.5 节 所 建议 的 ) 几乎 是 
不 可 能 的 。 实 用 性 和 趣味 性 需要 肉眼 与 主观 的 衡量 。 其 他 不 值得 自动 
化 检查 的 例子 有 : 直观 性 的 东西 ， 或 者 去 判定 某 些 东西 看 起 来 有 多 好 
或 者 用 起 来 有 多 容易 。 这 并 不 意味 着 对 此 类 例子 进行 讨论 、 举 例 说 
明 ， 或 者 将 其 存储 在 需求 说 明 系 统 中 就 没有 好 处 了 ， 事 实 恰恰 相反 。 
讨论 此 类 例子 可 以 确保 每 个 人 都 对 相关 功能 拥有 共同 的 认识 ， 只 是 手 
动 检查 可 以 更 为 高 效 。 

对 于 这 些 功能 的 测试 应 尽量 予以 自动 化 ， 这 样 可 以 帮助 我 们 只 
对 那些 自动 化 初期 或 长 期 维护 成 本 高 昂 的 一 些 少数 情况 ， 集 中 进行 手 
动 检查 。 

里 然 在 谈 到 用 户 界 面 时 我 主要 使 用 了 Web 应 用 程序 作为 例子 ， 但 
是 这 些 建议 同样 适用 于 其 他 类 型 的 用 户 界 面 。 在 应 用 程序 的 表皮 之 下 
进行 自动 化 可 以 让 我 们 验证 工作 流 和 session 约 束 ， 而 且 与 通过 用 户 界 
面 运行 测试 相 比较 ， 这 种 做 法 仍 能 缩短 反馈 时 间 。 前 面 我 们 大 致 看 了 
一 下 自动 化 的 管理 ， 是 时 候 谈 谈 自动 化 的 两 个 特定 方面 了 : 用 户 界面 
和 数据 管理 。 这 两 个 方面 导致 许多 团队 的 自动 化 出 现 了 问题 。 


9.4 行 


对 于 本 书 调研 所 涉及 的 那些 团队 来 讲 ， 在 实施 实例 化 需求 说 明 的 
过 程 中 ， 对 用 户 界面 进行 目 动 化 是 最 具 挑 战 性 的 方面 。 几 乎 所 有 我 采 
访 过 的 团队 都 在 早期 犯 过 同样 的 错误 。 他 们 在 制定 测试 的 时 候 ， 想 要 
通过 用 户 界 面 将 测试 作为 一 系列 技术 步骤 进行 自动 化 ， 并 且 往 往 会 在 
需求 说 明 中 直接 使 用 用 户 界 面 自动 化 的 命令 。 

用 户 界 面 的 目 动 化 程序 库 使 用 的 是 屏幕 对 象 的 语言 ， 本 质 上 是 软 
件 设 计 。 用 这 种 语言 描述 需求 说 明 直 接 与 提炼 需求 说 明 的 关键 思想 相 
矛盾 (请 参考 8.3.2 节 与 8.3.4 节 ) 。 这 种 做 法 除了 让 需求 说 明 难 以 理解 
外 ， 还 会 使 得 目 动 化 测试 的 长 期 维护 异常 艰难 。Pierre Veragen 的 团队 
就 曾 因 为 用 户 界面 的 一 个 小 改动 ， 不 得 不 抛弃 所 有 的 测试 : 

“用 户 界 面 测试 是 任务 导向 Crit. me) 而 非 行 为 导向 的 ， 因 此 
它们 与 GUI 的 实现 紧密 耦 舍 。 测 试 中 有 大 量 的 重复 。FitNesse 测 试 是 按 
照 UI 被 设 定 的 方式 来 组 织 的 。 当 UI 改变 时 ， 所 有 这 些 测试 都 必须 更 
新 。 这 时 从 概念 到 技术 的 转换 发 生 了 变化 。 对 GUI 的 一 个 小 改动 ， 比 
如 添加 一 个 ribbon 控 件 ， 都 会 破坏 所 有 测试 。 我 们 没有 办 法 去 更 新 测 
试 。” 

到 此 为 止 对 测试 的 所 有 投入 都 浪费 了 ， 因 为 对 他 们 来 说 抛弃 所 有 
测试 比 更 新 测试 来 得 简单 。 团 队 决定 对 应 用 程序 的 架构 进行 重组 以 便 
更 容易 地 进行 测试 。 

如 果 你 决定 通过 用 户 界面 来 自动 化 验证 一 部 分 需求 说 明 ， 那 么 对 
你 的 团队 来 说 ， 有 效 地 管理 该 自动 化 层 将 会 是 一 个 非常 重要 的 行为 。 
以 下 是 一 些 很 好 的 想法 ， 有 助 于 你 在 通过 用 户 界 面 进 行 目 动 化 测试 的 


将 从 业务 语言 到 用 户 界 面 对 象 语言 的 转译 放 入 到 目 动 化 层 ， 有 助 
于 避免 长 期 的 维护 问题 。 本 质 上 而 言 ， 这 意味 着 我 们 要 以 更 高 层次 的 


抽象 来 制定 用 户 界面 测试 。Aslak Hellesgy 说 这 就 是 他 早先 获得 的 一 条 
重要 经 验 : 

“我 们 意识 到 如 果 以 更 高 的 层次 来 编写 测试 ， 我 们 将 会 收益 颇 丰 。 
这 让 我 们 在 更 改 实现 时 无 需 改 变 大 量 功能 的 测试 脚本 。 因 为 测试 更 加 
短小 ， 所 以 更 容易 阅读 。 我 们 有 几 百 个 这 样 的 测试 ， 只 要 览 一 眼 就 可 
以 知道 它们 的 目的 是 什么 。 而 且 这 些 测试 也 更 具有 弹性 ， 方 便 修改 。>” 


Lance Walton 也 有 过 同样 的 经 历 ， 最 后 他 们 在 集成 层 里 创建 了 一 
些 类 ， 这 些 类 代表 了 用 户 界 面 的 操作 ， 然 后 他 们 将 抽象 级 别提 升 到 工 
作 流 的 高 度 ， 最 终 又 提升 到 更 高 级 别 的 行为 。 他 说 : 

“我 们 检查 了 许多 已 知 的 测试 ， 它 们 按照 “键入 这 个 ， 点 击 这 个 按 
钮 ;的 风格 编写 ， 结 果 发 现 它们 之 间 有 大 量 的 重复 。 我 们 本 能 地 进行 了 
重 构 并 且 意 识 到 我 们 需要 某 些 东 西 来 代表 屏幕 (页 面 ) 。 我 使 用 了 早 
期 的 XP 规则 : 如 果 一 小 段 表 达 式 拥有 具体 的 含义 ， 那 就 将 其 重 构成 一 
个 方法 并 给 它 命名 。 可 以 预知 我 们 的 每 个 测试 都 需要 登录 功能 ， 它 应 
该 是 可 以 重用 的 。 我 并 不 知道 应 该 怎么 做 ， 但 是 我 知道 我 们 迟早 会 那 
么 做 的 。 所 以 我 们 想到 了 将 屏幕 (页 面 ) 封装 成 类 。 

接 下 来 我 们 意识 到 ， 我 们 始终 以 同样 的 顺序 来 使 用 页 面 一 一 其 实 
就 是 一 个 工作 流 。 之 后 ， 我 们 明白 了 工作 流 仍 然 与 我 们 的 设计 方案 有 


关 ， 所 以 实际 上 我 们 可 以 撤 开 工作 流 进而 关注 用 户 想 要 完成 的 事情 。 
所 以 我 们 拥有 了 包含 具体 细节 的 页 面 ， 然 后 在 此 之 上 产生 了 任 
务 ， 之 后 又 形成 了 整个 工作 流 ， 最 后 树立 了 用 户 想 要 达成 的 目标 。 当 
我 们 到 达 那 个 层次 后 ， 编 写 测试 就 很 快 了 ， 并 且 即 使 程序 有 所 改动 ， 

测试 仍然 会 比较 健壮 。>” 

重新 组 织 自动 化 层 (以 处 理 各 种 行为 ， 同 时 关注 于 需求 说 明 的 测 
试 ， 而 非 脚本 ， 这 样 会 显著 减少 自动 化 测试 的 维护 成 本 ) 。Walton 
说 : 

“早先 ， 想 看 任何 内 容 都 必须 登录 。 后 来 产生 了 一 种 观念 ， 无 需 登 
录 也 可 以 看 很 多 内 容 ， 只 有 当 你 点 击 链 接 后 才 会 要 求 你 登录 。 如 果 你 
有 大 量 的 测试 需要 在 一 开始 就 进行 登录 ， 那 么 你 的 第 一 个 问题 就 是 ， 
在 你 去 掉 登 录 步 骤 之 前 ， 所 有 这 些 测试 统统 都 会 失败 。 但 是 当 你 点 击 
某 个 链接 之 后 却 必须 登录 ， 所 以 一 大 堆 测 试 也 会 因此 而 失败 。 如 果 你 
把 登录 抽象 出 来 ， 那 么 在 测试 里 以 某 个 具体 用 户 登 录 并 不 意味 着 立刻 
就 执行 一 一 你 可 以 将 用 户 信息 保存 起 来 ， 当 系统 要 求 登 录 时 再 派 上 用 
场 。 

测试 顺利 通过 。 当 然 ， 你 需要 额外 的 测试 来 检查 何 时 需要 登录 ， 
但 是 这 就 男 当 别论 了 。 那 些 用 于 检测 用 户 能 否 实现 其 目标 的 测试 ， 即 
便 系统 逻辑 发 生 显著 变化 ， 它 们 依然 还 是 很 健壮 的 。 我 们 居然 可 以 如 
此 容易 地 进行 这 个 改动 ， 这 令 我 很 惊奇 同时 也 印象 深刻 。 我 真 的 开始 
看 到 我 们 有 控制 这 些 东 西 的 能 力 。” 

通过 将 用 户 必 须 事先 登录 才能 执行 某 个 具体 操作 的 事实 与 实际 行 
A 〈 如 填写 登录 表格 、 提 交 并 登入 ) 区 分 开 来 ， 而 让 自动 化 层 决 定 何 
时 在 工作 流 中 执行 该 操作 (以 及 是 否 需 要 执行 该 操作 ) ， 这 样 可 以 让 
基于 此 需求 说 明 的 测试 更 具 修 改 的 弹性 。 同 时 这 还 提升 了 用 户 界面 操 
作 的 抽象 级 别 ， 让 读者 更 容易 理解 整个 需求 说 明 。 

> 从 更 高 的 抽象 层次 来 详细 说 明 用 户 界 面 的 功能 ， 可 以 让 团队 避 
免 在 业务 概念 与 用 户 界面 概念 之 间 进 行 转 译 。 同 时 还 会 让 验收 测试 更 
容易 理解 并 且 更 具 修 改 的 弹性 ， 降 低 长 期 的 维护 成 本 。 


天 于 如 何 组 织 用 户 界 面目 动 化 测试 才能 不 丢失 提炼 需求 说 明 的 好 
处 并 降低 长 期 的 维护 成 本 ， 请 参考 本 章 稍 后 9.4.3 节 附注 栏 的 内 容 。 


9.4.2 UI 需求 说 明 只 检查 UI 


GAT: 用 户 界面 包含 复杂 逻辑 时 

如果 可 执行 的 需求 说 明 是 以 与 用 户 界面 元 素 的 交互 来 描述 的 ， 
那么 请 在 需求 说 明 中 只 叙述 用 户 界 面 的 功能 。 

在 我 接触 过 的 团队 中 ， 以 较 低 的 技术 层次 来 描述 测试 却 又 没有 引 
起 大 量 维护 问题 的 团队 仅 有 一 个 ， 就 是 BNP Paribasin 银 行 的 Sierra 团 
队 。 他 们 有 一 组 可 执行 需求 说 明 ， 描 述 的 是 用 户 界面 元 素 之 间 的 交 
互 。 在 其 他 故事 中 ， 这 样 的 测试 必定 会 坊 出 厅 烦 ， 但 Sierra 团 队 通 过 只 
说 明 用 户 界 面 的 功能 而 不 包括 底层 的 领域 业务 逻辑 避免 了 这 种 困境 。 
例如 ， 他 们 的 测试 检查 表单 的 必 填 项 以 及 使 用 JavaScript 实 现 的 功能 。 
他 们 所 有 的 业务 逻辑 需求 说 明 都 是 在 用 户 界 面 层 之 下 自动 化 的 。 

毋庸 置疑 ， 提 高 抽象 层次 可 以 让 此 类 测试 更 易于 阅读 和 维护 。 但 
男 一 方面 ， 这 样 做 也 会 使 得 自动 化 层 极度 复杂 化 。 由 于 这 类 测试 的 数 
量 相 对 较 少 ， 因 此 创建 并 维护 一 个 灵活 的 自动 化 层 可 能 是 得 不 偿 失 
的 ， 当 用 户 界面 发 生变 化 时 直接 更 改 脚本 可 能 会 更 加 快捷 。 另 外 很 重 
要 的 一 点 是 ， 他 们 维护 的 是 一 个 后 台 办 公 系 统 ， 它 的 布局 不 会 像 面 向 
公众 的 网 站 ， 比 如 购物 窗口 那样 频繁 地 改动 。 


9.4.3 3 JAJU 


评 多 传统 的 测试 目 动 化 工具 提供 “录制 一 回放 ”用 尸 界 面目 动 化 的 
功能 。 虽 然 这 听 起 来 对 初期 的 自动 化 很 有 吸引 力 ， 但 是 “录制 一 回放 ” 
对 实例 化 需求 说 明 来 说 是 一 个 鉴 脚 的 做 法 。 这 也 是 可 执行 需求 说 明 的 
目 动 化 区 别 于 传统 自动 化 回归 测试 的 一 个 地 方 。 

~ 如 果 可 以 ， 尽 量 避 免 录制 用 户 界面 自动 化 。 录 制 的 脚本 除了 几 
平 无 法 理解 外 ， 还 难以 维护 。 它 降低 了 创建 脚本 的 成 本 却 会 显著 增加 
维护 成 本 。 


Pierre Veragen 的 团队 曾经 有 7 万 行 用 户 界 面 回归 测试 的 录制 脚本 。 
为 了 与 用 户 界 面 的 重大 变更 保持 一 致 ， 他 们 好 几 个 人 花 了 6 个 月 的 时 间 
才 重 新 录制 完 脚本 。 如 此 慢 的 反馈 使 得 可 执行 需求 说 明 的 所 有 益处 都 
完全 失效 。 此 外 ，“ 录 制 一 回放 ”的 自动 化 需要 现成 的 用 户 界面 ， 而 实 
例 化 需求 说 明 则 是 在 编写 软件 之 前 就 开始 了 。 

有 些 团 队 一 开始 不 理解 传统 回归 测试 与 实例 化 需求 说 明 的 这 个 区 
别 ， 他 们 尝试 使 用 了 “录制 一 回放 ”工具 。Christian Hassa 的 故事 就 比较 
典型 : 

“这 种 测试 太 脆弱 了 并 且 维 护 开销 非常 大 。Selenium 测 试 是 录制 
的 ， 因 此 生成 测试 的 时 间 还 是 太 迟 了 。 首 先 ， 我 们 试 着 在 sprint 未 尾 
录制 已 经 开发 的 功能 。 然 后 我 们 试 着 将 所 录制 的 脚本 抽象 成 更 具 重 用 
性 且 不 那么 脆弱 的 测试 。 但 最 终 ， 还 是 要 由 测试 人 员 自 己 决定 测试 的 
方法 。 我 们 要 到 很 晚 才 了 解 测试 人 员 是 如 何 理解 用 户 的 期 望 的 。 同 
时 ， 我 们 也 落后 于 进度 。 由 于 我 们 必须 不 断 维 护 所 有 这 些 内 容 ， 所 以 
实际 上 情况 越 来 越 糟 。6 个 月 之 后 ， 我 们 使 用 的 脚本 已 经 无 法 维护 了 。 

这 种 方法 我 们 使 用 了 几 个 月 ， 并 且 还 想方设法 去 做 改善 ， 但 还 是 
不 管用 ， 所 以 我 们 在 项 目 末 期 将 这 些 测试 全 部 抛弃 了 。 当 时 我 们 编写 
的 测试 结构 不 好 ， 不 像 我 们 现在 使 用 的 组 织 方式 ， 那 时 使 用 的 是 传统 
测试 人 员 组 织 测 试 的 方式 : 大 量 的 前 置 条 件 ， 然 后 是 一 些 断 言 ， 然 后 
即将 进行 的 事情 又 成 为 下 一 个 测试 的 前 置 条 件 。>” 

用 户 界面 自动 化 的 3 个 层次 

编写 通过 用 户 界面 自动 化 的 可 执行 需求 说 明 时 ， 请 考虑 使 用 以 下 3 
个 层次 来 描述 需求 说 明 与 自动 化 。 

业务 规则 层 。 测 试 所 展示 的 或 所 操作 的 是 什么 ? 例如 : 为 购买 2 本 
或 2 本 以 上 书籍 的 客户 提供 免费 送 货 服 务 。 

用 户 工 作 流 层 。 用 户 如 何 通 过 UI 使 用 某 个 功能 ， 以 更 高 的 行为 级 
别 应 该 怎么 描述 ? 例如 : 将 2 本 书 放 入 购物 车 ， 输 入 地 址 信息 ， 然 后 验 
证 配送 选项 是 否 包 含 免费 送 货 服务 。 


技术 行为 层 。 操 作 单 个 工作 流 的 步骤 需要 哪些 技术 性 步骤 ? 例 
如 : 打开 店铺 主页 ， 使 用 “testuser” 与 “testpassword” 登 录 ， 跳 转 到 
“/book” 页 面 ， 点 击 CSS 类 是 “book” 的 第 一 个 图 片 ， 等 待 页 面 加 载 结 
束 ， 点 击 购买 链接 等 。 

需求 说 明 应 该 以 业务 规则 层 来 描述 。 自 动 化 层 应 该 通过 组 舍 技 术 
行为 层 上 编写 的 程序 块 来 处 理 用 户 工作 流 层 。 这 样 的 测试 易于 理解 、 
编写 高 效 ， 而 且 维 护 成 本 也 相对 较 低 。 

关于 UI 测试 3 个 层次 的 更 多 信息 ， 请 参考 我 的 文章 “编写 UI 测试 时 
如 何不 搬 起 石头 砸 自己 的 脚 ”" 。 


注释 : QDhttp://gojko.net/2010/04/13/how-to-implement-ui-testing- 
without-shootingyourself-in-the-foot-2 


alee 


9.4.4 AL 


~ 即使 通过 用 户 界 面 进行 自动 化 是 自动 化 可 执行 需求 说 明 的 唯一 
方式 ， 许 多 团队 发 现 通过 直接 在 数据 库 里 准备 环境 ， 可 以 显著 提高 测 
试 的 执行 速度 。 

例如 ， 当 自动 化 一 个 描述 编辑 如 何 审核 文章 的 需求 说 明 时 ， 我 们 
可 以 调用 数据 库 来 预先 创建 文章 。 如 果 你 使 用 前 一 小 节 附 注 栏 中 提 到 
的 3 个 层次 ， 那 么 工作 流 层 的 某 些 部 分 可 以 通过 用 户 界 面 来 实现 ， 而 某 
些 部 分 则 可 以 使 用 领域 API 或 调用 数据 来 做 优化 。Ultimate 软 件 公司 的 
Global Talent Management 团 队 就 使 用 了 这 种 方法 ， 不 过 他 们 把 工作 拆 
分 开 来 ， 让 测试 人 员 仍然 可 以 有 效 地 参与 进去 。Scott Berger 是 这 么 解 
释 的 : 

“理想 情况 下 ， 开 发 人 员 会 利用 数据 库 自动 化 层 构 建 数据 ， 他 们 会 
编写 自动 化 代码 快速 打通 主要 通道 ， 然 后 测试 人 员 接 手 加 入 额外 的 用 
例 对 其 进行 扩展 。>” 

通过 尽早 自动 化 这 整个 通道 ， 开 发 人 员 可 以 利用 自己 的 知识 优化 
测试 。 有 了 第 一 个 自动 化 的 例子 后 ， 测 试 人 员 与 分 析 师 就 可 以 很 容易 
地 扩展 需求 说 明 ， 在 业务 规则 层 加 入 更 多 的 例子 。 


在 数据 库 中 建立 测试 的 上 下 文 环 境 ， 带 来 了 第 二 大 挑战 ， 也 正 是 
我 调研 时 采访 的 那些 团队 在 目 动 化 可 执行 需求 说 明 中 所 面 对 的 问题 : 
数据 管理 。 为 了 增强 对 系统 的 信心 ， 或 者 由 于 他 们 的 领域 是 数据 驱动 
的 ， 有 些 团队 会 把 数据 库 包 含 在 持续 验证 过 程 中 。 这 为 自动 化 带 来 了 
一 组 新 的 挑战 。 


9.5 管理 测试 数据 


为 了 使 可 执行 的 需求 说 明 具 有 专注 和 不 言 自明 的 特质 ， 需 求 说 明 
应 该 包含 所 有 重要 的 数据 用 以 对 功能 进行 举例 说 明 ， 同 时 要 省 略 其 他 
信息 。 但 对 于 一 个 使 用 数据 库 的 系统 ， 由 于 数据 引用 的 完整 性 检查 ， 
我 们 通常 还 需要 额外 的 数据 才能 完全 自动 化 该 系统 的 所 有 例子 。 

依赖 于 数据 库 数据 的 上 自动 化 测试 还 有 另外 一 个 问题 ， 那 就 是 某 一 
个 测试 可 能 会 更 改 另 一 个 测试 所 需 的 数据 ， 使 得 测试 结果 并 不 可 靠 。 
另 一 方面 ， 为 了 获得 快速 反馈 ， 我 们 又 不 能 在 每 一 个 测试 里 删除 和 恢 
复 整 个 数据 库 。 

有 效 地 管理 测试 数据 是 非常 关键 的 ， 它 可 以 增进 我 们 对 数据 驱动 
的 系统 的 信心 ， 还 可 以 让 持续 验证 过 程 保持 快速 、 可 重复 而 且 可 靠 。 
本 世 中 ， 我 将 展示 一 些 管 理 测 斌 数据 的 好 方法 ， 我 采访 的 一 坚 团队 残 
是 用 它们 来 管理 其 可 执行 需求 说 明 的 测试 数据 的 。 
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适用 于 : 说 明 非 数据 驱动 的 逻辑 时 

~ 重用 现 有 数据 可 能 会 使 得 需求 说 明 更 加 难以 理解 。 

当 自 动 化 的 可 执行 需求 说 明 使 用 了 数据 库 时 ， 在 数据 库 中 的 数据 
就 成 了 自动 化 上 下 文 的 一 部 分 。 某 些 团 队 并 没有 在 测试 开始 前 将 上 下 
文 信息 自动 放 入 到 数据 库 中 ， 而 是 重用 符合 其 目的 的 已 有 数据 。 这 可 
以 让 需求 说 明 更 容易 自动 化 ， 却 使 得 它们 更 难 理解 。 阅 读 此 类 需求 说 
明 的 人 必须 同时 理解 数据 库 中 的 数据 。 针 对 这 一 问题 ，Channing 
Walton 这 样 建 议 道 : 


“通过 预 填充 来 建立 一 个 拥有 基准 数据 集 的 数据 库 总 会 带 来 很 多 痛 
苦 。 理 解 那些 数据 是 什么 、 为 什么 需要 那些 数据 以 及 它 有 什么 用 处 是 
一 件 比较 困难 的 事情 。 当 测试 失败 时 ， 也 难以 了 解 个 中 原因 。 由 于 数 
据 是 共享 的 ， 测 试 之 间 会 互相 影响 。 大 家 很 快 就 会 被 搞 得 墅 头 转向 。 
这 是 一 种 不 成 熟 的 优化 。 请 编写 与 数据 无 关 的 测试 。” 

如 果 系 统 的 设计 方式 并 不 需要 设置 大 量 的 引用 数据 ， 那 么 目 动 化 
需求 说 明 只 需 定 义 最 少量 的 上 下 文 信息 。 换 个 角度 来 看 ， 实 例 化 需求 
说 明 可 以 指导 团队 设计 专注 的 、 低 耦合 的 组 件 ， 这 也 是 面向 对 象 设 计 
原则 里 最 重要 的 一 条 。 不 过 ， 在 遗留 的 数据 驱动 系统 里 很 难 做 到 这 一 


适用 于 : 数据 驱动 的 系统 

由 数据 驱动 的 系统 上 下 文 很 难 准备 齐全 ， 而 且 也 很 容易 出 错 。 从 
需求 说 明 要 专注 的 角度 来 说 ， 这 么 做 也 不 见得 是 最 好 。Gaspar Nagy 的 
团队 曾经 试 着 这 么 做 ， 结 果 发 现 需求 说 明 变 得 难以 阅读 和 维护 了 : 

“我 们 有 一 个 验收 测试 需要 在 数据 库 准 备 数 据 才能 执行 。 当 我 们 编 
写 了 准备 数据 的 描述 后 ， 发 现 它 看 起 来 像 数据 库 表 。 虽 然 文 本 中 没有 
出 现 ‘ 表 ;这 个 字眼 ， 但 确 确实 实 是 数据 库 表 。 这 对 开发 人 员 来 说 很 容 
易 理 解 ， 但 是 对 业务 人 员 来 说 就 难 了 。 

例如 ， 我 们 有 一 个 ‘国家 ’ 表 。 我 们 不 想 在 测试 自动 化 中 硬 编码 任 
何 ‘ 国 家 ;相关 的 逻辑 ， 所 以 与 此 相关 的 所 有 测试 都 各 自 定义 了 ‘国家 ’ 数 
据 。 结 果 我 们 都 犯 傻 了 ， 因 为 定义 ‘国家 ;的 时 候 我 们 都 只 用 了 “ 匈 牙 
利和 法国?。 其 实 我 们 可 以 在 数据 库 里 事先 准备 好 全 世界 所 有 国家 的 
数据 ， 然 后 在 测试 里 ‘Given 系 统 已 经 有 一 些 缺 省 的 国家 数据 '"。 事 先 准 
备 默 认 的 数据 集 本 来 会 很 有 帮助 的 。” 

Marco Milone 也 碰 到 过 类 似 的 问题 ， 当 时 他 在 做 新 媒体 产业 的 项 
H: 

“起 初 ， 为 了 让 测试 运行 ， 我 们 没有 做 到 位 。Setup 和 Teardown 都 
在 测试 内 部 ， 很 杂乱 。 之 后 ， 我 们 集中 了 数据 准备 并 控制 变更 。 测 试 


只 执行 检测 ， 无 需 准 备 数据 。 如 此 一 来 ， 测 试 变 得 更 快 、 更 易 阅读 并 
且 更 易 管理 。>” 

在 数据 驱动 的 系统 中 ， 重 新 创建 所 有 的 数据 并 不 是 一 个 好 主意 。 
同样 ， 隐 藏 信息 也 会 导致 很 多 问题 。 对 此 ， 爱 荷 华 州 助 学 贷 款 公司 的 
团队 实施 的 策略 是 个 不 错 的 方案 。 他 们 只 会 事先 准备 那些 不 会 变动 的 
引用 数据 。Tim Andersen 是 这 么 描述 这 种 方法 的 : 

“我 们 在 构建 过 程 中 清理 并 设置 数据 库 ， 然 后 填充 配置 数据 以 及 领 
域 相 关 的 测试 数据 ， 其 余 交 易 数据 由 每 个 测试 自己 负责 创建 并 清理 。” 

- 使 用 预 填 充 的 引用 数据 是 个 不 错 的 策略 ， 它 可 以 让 测试 说 明 更 
加 短小 并 更 容易 理解 ， 与 此 同时 它 还 可 以 加 快 反馈 并 简化 自动 化 层 。 

如 果 你 决定 使 用 预 填 充 的 引用 效 据 ， 请 参考 10.1.9 厂 ， 了 解 一 下 如 
何 让 测试 变 得 更 加 可 靠 。 


9.5.3 y 


适用 于 : 遗留 的 数据 驱动 系统 

某 些 领域 非常 复杂 ， 即 使 使 用 了 预 填充 的 引用 数据 ， 从 头 设置 新 
的 对 象 仍然 是 一 项 复杂 而 且 容 易 出 错 的 任务 。 如 果 你 是 在 一 个 全 新 的 
项 目 里 碰 到 这 个 问题 ， 而 且 其 领域 模型 也 在 你 的 控制 之 下 ， 那 么 这 可 
能 是 领域 模型 有 问题 的 征兆 〈 请 参考 第 11 章 的 11.4 节 ) 。 

在 遗留 的 数据 驱动 系统 里 可 能 无 法 修改 模型 。 这 种 情况 下 ， 不 需 
要 完全 从 头 开 始 创建 新 对 象 ， 只 需 在 自动 化 层 里 克隆 已 有 对 象 并 修改 
相关 的 属性 即 可 。Berge Lotre 和 Mikael Vik 在 挪威 的 奶牛 记录 系统 里 使 
用 了 这 种 方法 。 他 们 说 : 

“由 于 领域 的 复杂 性 ， 为 测试 准备 尽 可 能 完整 的 数据 是 个 挑战 。 如 
果 我 们 要 测试 “奶牛 ”的 行为 ， 却 忘记 了 定义 奶牛 有 3 只 小 牛犊 的 测试 用 
例 ， 那 么 在 使 用 真实 数据 进行 手动 测试 前 ， 我 们 无 法 看 到 代码 出 错 ， 
也 无 法 发 现 问题 。 所 以 我 们 创建 了 一 个 可 以 辨识 真实 ' 奶 牛 ' 的 数据 生 
成 器 ， 它 会 从 数据 库 中 获取 属性 。 然 后 这 些 属性 会 作为 基础 数据 用 在 
新 的 Cucumber 测 试 里 。 这 不 仅 会 在 我 们 需要 重 现 错误 时 有 所 帮助 ， 

而 且 还 会 在 我 们 开始 编写 新 的 需求 时 提供 帮助 。>” 


当 Bekk 的 团队 发 现 一 个 遗漏 的 测试 用 例 时 ， 他 们 会 在 真实 的 数据 
库 里 找 出 一 个 具有 代表 性 的 例子 ， 并 利用 其 属性 让 “数据 生成 器 ”为 目 
动 化 的 验收 测试 做 准备 。 这 样 可 以 确保 复杂 对 象 拥有 所 有 有 关 的 数据 
并 引用 相关 的 对 象 ， 这 会 让 验证 检查 更 为 确切 。 为 了 更 快 地 从 它们 的 
可 执行 需求 说 明 中 获取 有 反馈， 数据 生成 器 会 获得 一 个 对 象 的 完整 上 下 
文 ， 这 使 得 测试 可 以 运行 在 内 人 存 数据 库 中 。 

~ 在 数据 库 中 找 一 个 具有 代表 性 的 例子 ， 并 用 其 属性 来 准备 测 
Wo 

为 测试 做 准备 时 ， 使 用 这 种 方法 来 快速 创建 对 象 而 不 是 创建 数据 
ERS (结合 实际 的 数据 库 ) ， 还 可 以 简化 在 可 执行 的 需求 说 明 中 为 
相关 实体 做 准备 的 工作 。 我 们 可 以 只 说 明 那 些 对 获取 一 个 好 的 原型 比 
较 重 要 的 属性 ， 而 不 是 说 明 一 个 对 象 的 所 有 属性 。 这 会 让 需求 说 明 更 
容易 理解 。 

自动 化 验证 而 不 修改 需求 说 明 ， 与 传统 的 测试 自动 化 具有 概念 
的 区 别 ， 这 就 是 为 何 有 如 此 多 的 团队 在 刚 开始 实施 实例 化 需求 说 明 时 
颇 费 周章 的 原因 。 我 们 对 需求 说 明 进 行 自动 化 是 为 了 获得 快速 反馈 ， 
但 我 们 的 主要 目的 应 该 是 创建 易于 访问 、 简 单 易 懂 的 可 执行 需求 说 
明 ， 而 不 仅仅 是 为 了 自动 化 验证 过 程 。 一 旦 需求 说 明 可 以 执行 ， 我 们 
就 可 以 频繁 地 对 其 进行 验证 ， 建 立 起 一 个 活 文档 系统 。 我 们 将 在 接 下 
来 的 两 章 中 涉及 这 些 概 念 。 


9.6 铭记 


自动 化 提炼 好 的 需求 说 明 时 必须 尽量 减少 改动 。 

自动 化 层 应 该 定义 如 何 进行 测试 ， 而 需求 说 明 则 应 该 定义 要 测试 
什么 内 容 。 

使 用 目 动 化 层 执 行业 务 语言 与 用 户 界 面 、API 和 数据 库 之 间 的 转 
换 。 为 需求 说 明 创 建 更 高 级 别 的 可 重用 组 件 。 

尽 可 能 在 用 户 界 面 之 下 进行 目 动 化 。 

除非 万 不 得 已 ， 否 则 不 要 太 依赖 于 现存 数据 。 


第 10 章 频繁 验证 


“偏离 车 道 时 ， 响 亮 的 振动 声 立 刻 就 会 引起 你 的 注意 。” 
David Haldane© 


注释 : Ohttp://articles.latimes.com/1997-03-07/local/me- 
35781_1_botts-dots 


在 20 世 纪 50 年 代 ， 美 国 加 州 的 交通 部 深 受 机 动车 车 道 线 问 题 的 困 
扰 。 车 道 线 会 和 褪色， 每 个 季 蔬 都 需要 重新 喷涂 。 不 仅 费 用 高 昂 WA 
扰乱 交通 ， 而 且 对 喷涂 的 工人 来 说 还 很 危险 。 

Elbert Dysart Botts 博 士 致力 于 解决 这 个 问题 ， 他 做 了 很 多 试验 ， 
试图 寻找 更 加 反光 的 涂料 ， 但 最 终 都 证 明 那 是 死路 一 条 。 跳 出 条 条 框 
框 ， 放 开 思 路 后 ， 他 发 明了 突起 的 车 道 标 志 ， 称 作 Botts 点 。 无 论 什 么 
天 气 ， 白 天 黑夜 都 能 看 得 见 Botts 点 。 它 们 不 会 像 喷涂 的 车 道 线 一 样 容 
易 褪 色 。 当 司机 越过 指定 的 车 道 时 ， 除 了 视觉 ， 司 机 还 可 以 感受 到 
Botts 点 产生 的 振动 以 及 隆隆 的 振动 声 。 已 经 证 明 这 种 反馈 是 高 速 公路 
上 最 重要 的 安全 特性 之 一 ， 当 漫不经心 的 司机 偏离 车 道 时 可 以 警告 他 
们 即将 发 生 危险 。 

Botts 点 作为 最 早 的 12 个 极限 编程 实践 之 一 引入 到 软件 开发 中 ， 称 
作 持 续集 成 (CI)。 当 跑 忽 大 意 的 软件 团队 开始 偏离 产品 必须 时 时 可 构 
建 和 可 交付 的 原则 时 ， 持 续集 成 就 会 发 出 警示 。 专 用 的 持续 集成 系统 
会 频繁 地 构建 产品 并 运行 测试 以 确保 系统 不 仅仅 在 开发 人 员 的 机 器 上 
运行 正常 。 这 一 实践 通过 快速 地 找到 潜在 问题 让 我 们 保持 在 正确 的 道 
路 上 ， 并 在 必要 时 只 要 采取 小 而 廉价 的 措施 就 可 以 纠正 。 持 续集 成 可 
以 确保 产品 在 被 正确 地 构建 起 来 后 ， 能 始终 保持 正确 。 

同样 的 原则 也 可 以 应 用 到 构建 正确 的 产品 上 。 一 旦 构建 了 正确 的 
产品 ， 我 们 就 要 确保 它 一 直 正 确 。 当 它 偏 离 设 计 的 方向 时 ， 只 要 我 们 
能 尽早 地 知道 ， 就 可 以 更 容易 更 廉价 地 解决 问题 ， 不 让 问题 累积 起 


来 。 我 们 可 以 频繁 地 验证 可 执行 的 需求 说 明 。 持 续 构 建 的 服务 器 2 可 
以 频繁 地 检查 所 有 的 需求 说 明 ， 并 保证 系统 始终 符合 需求 。 


注释 : 包 当 有 人 改变 版 本 控制 系统 中 的 任何 代码 时 ， 进 行 自 动 构 
建 、 打 包 、 运 行 测试 的 软件 。 如 果 你 从 没有 听 说 过 ， 请 用 Google 搜 索 
Cruisecontrol、HudSon 或 TeamCity。 


持续 集成 是 一 个 有 完备 文档 记录 的 软件 实践 ， 已 有 许多 作者 对 它 
作 了 话 尽 的 描述 。 我 不 想 兹 统 地 重复 如 何 搭建 持续 构建 与 集成 的 系 
统 ， 但 是 有 些 关 于 可 执行 需求 说 明 频 每 验证 的 难点 对 于 本 书 的 主题 十 
分 重要 。 

许多 团队 使 用 实例 化 需求 说 明 来 扩展 现 有 系统 ， 他 们 发 现 可 执行 
的 需求 说 明 必 须 运行 在 真实 1 的 数据 库 上 ， 有 真实 的 数据 、 外 部 服务 或 
完整 部 署 的 网 站 。 功 能 验收 测试 通过 许多 组 件 来 检查 功能 ， 如 果 系 统 
事先 不 具有 可 测试 性 ， 那 么 此 类 检查 往往 需要 集成 部 署 整个 系统 才 可 
进行 。 除 了 一 般 持续 集成 用 到 的 技术 性 的 〈 单 元) 测试， 上 述 情况 还 
会 党 来 其 他 3 组 关于 频繁 验证 的 问题 : 

依赖 环境 而 导致 不 稳定 。 单 元 测试 一 般 独 立 于 测试 环境 ， 但 是 可 
执行 需求 说 明 可 能 强烈 依赖 于 它们 运行 的 生态 系统 。 即 使 代码 正确 ， 
环境 问题 也 会 导致 测试 失败 。 为 了 对 验收 测试 结果 更 有 信心 ， 我 们 必 
须 解决 或 碱 少 这 些 环境 问题 ， 使 测试 执行 更 为 可 靠 。 

反馈 较 慢 。 遗 留 项 目的 功能 验收 测试 运行 速度 通常 比 单元 测试 慢 
很 多 。 如 果 单 元 测试 需要 运行 几 分 钟 ， 我 就 认为 它 是 比较 慢 的 了 。 将 
近 10 分 钟 的 单元 测试 绝对 是 太 慢 了， 我 会 很 认真 地 研究 如 何 提高 速 
度 。 另 一 方面 ， 我 见 过 许多 验收 测试 需要 长 达 数 小 时 的 运行 时 间 ， 除 
非 牺 牲 测试 的 可 信和 度 ， 否 则 很 难 进行 优化 。 整 体 反馈 是 如 此 之 慢 ， 我 
们 需要 想 出 一 种 解决 方案 ， 使 得 系统 某 些 指定 的 部 分 可 以 按 要 求 提 供 
快速 反馈 。 

对 失败 测试 的 管理 。 大 量 粗 粒度 的 、 依 赖 于 许多 活动 部 件 的 功能 
测试 ， 要 求 一 些 团 队 (特别 是 那些 刚 开 始 实施 实例 化 需求 说 明 的 团 


队 ) 去 管理 失败 的 测试 而 不 是 直接 进行 修复 。 
本 章 我 将 解释 我 调研 过 的 这 些 团 队 是 如 何 处 理 这 3 个 问题 的 。 


10.1 提高 稳定 性 


不 稳定 的 验证 过 程 会 削弱 团队 对 产品 和 实例 化 需求 说 明 过 程 的 信 
心 。 调 查 那些 间歇 性 的 又 不 是 由 真正 问题 导致 的 失败 会 浪费 大 量 的 时 
间 。 如 果 这 种 事情 经 常 发 生 ， 开 发 人 员 就 有 了 根本 不 去 查看 验证 问题 
的 借口 。 这 会 让 真正 的 问题 逃 过 检测 ， 使 整个 持续 验证 变 得 没 意 义 。 

遗留 项 目 基本 无 法 很 容易 地 做 自动 化 功能 测试 ， 所 以 可 执行 的 需 
求 说 明 可 能 需要 通过 不 可 靠 的 用 户 界 面 来 自动 化 ， 或 者 要 在 异步 流程 
市 来 的 不 确定 性 中 苦 藻 挣扎 。 当 我 们 需要 说 服 开 发 人 员 参 与 到 过 程 中 
去 ， 而 开发 人 员 只 将 其 看 作 是 功能 测试 的 改进 版 GRA, ARE 
他 们 的 问题 ) 时 ， 问 题 变 得 尤其 环 手 。 

Clare McLennan 和 她 的 团队 就 碰 到 了 这 样 的 问题 。“ 因 为 测试 本 身 
不 稳定 ， 所 以 开发 人 员 不 关心 这 些 测试 。 然 而 我 们 就 是 需要 开发 人 员 
的 知识 来 使 测试 变 得 稳定 。” 对 她 的 团队 来 说 这 是 个 鸡 生 和 蛋 蛋 生 鸡 的 问 
题 。 为 了 让 开发 人 员 参 与 进来 ， 她 必须 让 开发 人 员 看 到 可 执行 需求 说 
明 的 价值 。 但 是 ， 只 有 稳定 可 靠 的 可 执行 需求 说 明 才 能 展现 出 它 的 价 
值 。 而 需求 说 明 要 想 稳 定 可 靠 ， 则 必须 要 开发 人 员 修改 系 统 设计 ， 使 
系统 易于 自动 化 测试 时 才能 实现 。 

为 了 获得 实例 化 需求 说 明 的 长 远 收益 ， 许 多 团队 不 得 不 投入 大 量 
的 精力 让 验证 过 程 变 得 可 靠 起 来 。 本 节 我 将 前 述 关 于 这 方面 的 一 些 很 
好 的 想法 。 


10.1.1 找 出 最 烦人 的 问题 六 Hee 1 

适用 于 : 系统 对 自动 化 测试 支持 得 不 够 好 时 

要 想 在 系统 上 更 加 可 靠 地 运行 目 动 化 测试 ， 最 重要 的 一 点 是 要 明 
白 这 样 的 改变 不 是 一 跳 而 就 的 。 要 改变 一 个 遗留 系统 不 容易 ， 合 则 它 


也 不 会 叫做 “遗留 "系统 了 。 当 某 种 东西 在 多 年 的 构建 过 程 中 都 没有 丝 
毫 的 “可 测试 性 ”设计 时 ， 想 要 瞬间 变 得 清晰 可 测试 是 不 可 能 的 。 

快速 地 引入 太 多 重大 修改 会 使 系统 变 得 不 稳定 ， 尤 其 是 在 功能 测 
试 履 盖 率 不 高 的 时 候 。 它 会 严重 打 乱 开发 流程 。 

- 不 要 想 一 下 子 就 解决 问题 ， 更 有 效 的 策略 是 一 个 迭代 一 个 迭代 
地 做 些小 的 改变 。 

比如 ，McLennan 的 团队 意识 到 缓慢 的 测试 数据 处 理会 导致 测试 超 
时 。 他 们 的 数据 库 管 理 员 改 善 了 数据 库 性 能 ， 这 让 他 们 发 现 有 些 测试 
在 测试 数据 更 新 前 就 开始 了 ， 所 以 系统 一 直 在 用 老 数 据 。 他 们 引入 了 
消息 机 制 告 诉 测试 何 时 数据 库 里 准备 好 了 最 新 的 数据 ， 之 后 他 们 就 可 
以 可 靠 地 开始 测试 ， 避 免 假 漏 报 率 。 当 不 可 预测 性 的 源头 解决 之 后 ， 
他 们 发 现 HTTP cookie 过 期 导致 了 一 些 问题 。 于 是 他 们 引入 了 业务 时 间 
的 概念 ， 这 样 他 们 就 可 以 修改 系统 时 间 。 ( 见 本 章 稍 后 的 10.2.1 节 。) 

作为 提高 自动 化 测试 稳定 性 的 策略 ，McLennan 提 出 了 增 量 方法 : 

“找到 最 烦人 的 问题 并 将 其 解决 掉 ， 然 后 别 的 问题 又 会 变 成 最 烦人 
的 问题 ， 解决 之 后 ， 目标 再 次 转向 另 一 个 最 烦人 的 问题 。 如 此 不 断 重 
复 ， 最 终 的 系统 将 会 非常 稳定 ， 非 常 有 用 。>” 

一 个 迭代 一 个 迭代 地 提高 稳定 性 是 构建 可 靠 验 证 过 程 的 好 方法 ， 
同时 又 不 会 过 多 地 妨碍 交付 流程 。 这 种 方法 还 可 以 让 我 们 在 提高 系统 
可 测 性 的 过 程 中 不 断 学 习 并 适应 。 


10.1.2 用 CI 疯 到 疯 


适用 于 : 在 遗留 系统 中 引入 自动 化 测试 时 

对 一 个 不 具有 目 动 化 测试 设计 的 遗留 系统 来 说 ， 由 于 存在 太 多 导 
致 不 稳定 的 地 方 ， 想 要 做 增 量 式 清 理 ， 往 往 还 是 无 从 下 手 。 有 个 不 错 
的 万 法 是 查看 测试 的 执行 历史 。 当 今 大 多 数 持续 构建 系统 都 可 以 跟踪 
一 段 时 间 的 测试 结果 。 

~ 只 要 可 执行 需求 说 明 在 持续 构建 (CD 系统 中 运行 ， 我 们 就 可 以 
从 测试 的 运行 历史 中 看 到 哪些 测试 最 不 稳定 。 

多 年 以 来 我 完全 下 忽 了 这 个 功能 ， 因 为 我 参与 的 大 多 是 事先 考虑 
了 可 测试 性 的 新 项 目 ， 或 者 是 那些 只 需 少量 的 改动 融 很 称 定 的 系统 。 
在 这 些 项 目 中 ， 跟 蹊 测 试 执 行 历史 没什么 用 : 测试 几乎 一 直 都 是 通过 
的 ， 即 使 失败 也 很 快 就 修复 了 。 我 第 一 次 尝试 改进 自动 化 测试 的 系 
统 ， 是 一 个 偶尔 有 超时 间 题 、 网 络 问题 、 数 据 库 问 题 以 及 不 一 致 问题 
的 系统 ， 查 看 测试 历史 能 帮助 我 集中 精力 提高 稳定 性 。 这 个 功能 告 i 
了 我 哪些 测试 最 经 单 失败 ， 因 而 必须 最 先 修复 。 


10.1.3 措 建 专用 的 持续 验证 环境 


~ 如 果 你 的 应 用 程序 需要 部 署 ， 并 且 要 运行 功能 测试 ， 那 么 保证 
可 重 现 性 的 第 一 步 就 是 确保 专用 的 部 署 环境 。 


持续 验证 必须 以 可 重 现 的 方式 进行 工作 ， 这 样 才 可 靠 。 在 一 些 大 
型 的 组 织 中 ， 获 取 一 批 新 机 器 要 比 雇用 有 名 的 投 毒 杀人 犯 担 任 公司 自 
助 餐厅 的 大 厨 还 要 难 ， 但 是 争取 更 好 的 环境 依然 是 值得 的 。 许 多 团队 
将 一 个 环境 用 作 不 同 的 用 途 ， 比 如 为 商业 用 户 演示 功能 、 手 工 测 试 以 
及 持续 验证 。 这 往往 会 导致 数据 的 一 致 性 问题 。 

没有 专用 的 环境 ， 很 难 知道 测试 失败 是 由 于 存在 缺陷 、 由 于 有 人 
对 测试 环境 做 了 改变 ， 还 是 由 于 系统 不 稳定 所 导致 的 。 专 用 的 环境 可 
以 排除 计划 外 的 改变 ， 并 可 以 降低 环境 不 稳定 的 风险 。 


10.1.4 去 


一 旦 我 们 有 了 专用 环境 ， 我 们 要 确保 软件 以 可 重复 的 方式 部 署 。 
不 可 靠 的 部 署 是 测试 结果 不 稳定 的 第 二 个 最 常见 的 原因 。 对 于 许多 遗 
留 系统 ， 部 署 需要 整 晚 的 时 间 ， 需 要 多 名 人 员 、 大 量 的 咖啡 ， 最 好 还 
要 有 个 魔法 棒 。 如 果 我 们 每 年 只 需 部 署 一 次 ， 还 是 可 以 接受 的 。 然 
而 ， 当 我 们 需要 每 两 周 部 署 一 次 时 ， 这 就 是 一 件 非常 头疼 的 事情 了 。 
为 了 持续 验证 ， 我 们 可 能 需要 一 天 部 署 几 次 ， 需 要 魔法 相助 的 手动 部 
署 是 完全 难以 让 人 接受 的 。 

没有 全 自动 部 署 来 可 靠 地 升级 系统 ， 我 们 就 会 频繁 地 碰 到 这 样 的 
情况 : 许多 测试 突然 开始 失败 ， 有 人 得 花 上 数 小 时 寻找 罪魁 祸首 ， 结 
果 只 会 听 到 房间 后 面 有 人 说 “但 是 这 在 我 机 器 上 是 好 的 ”。 

= 全 自动 部 署 可 以 确保 升级 只 有 唯一 的 标准 流程 ， 同 时 可 以 确保 
所 有 的 开发 人 员 拥 有 和 测试 环境 一 样 的 系统 部 署 。 

这 排除 了 可 执行 需求 说 明 对 特定 环境 的 依赖 ， 可 以 大 幅 提 高 持续 
验证 的 可 靠 性 。 同 时 也 更 容易 排除 故障 ， 因 为 开发 人 员 可 以 用 任何 环 
境 来 重 现 问题 。 

部 署 必 须 完 全 自动 化 才 行 。 完 全 不 需要 或 不 允许 手动 干预 。 ( 注 
意 我 是 说 可 以 按 需 执行 的 全 自动 部 署 ， 没 必要 自动 触发 部 署 。) WR 
安装 程序 需要 处 理 管理 员 控 制 台 或 者 半自动 化 的 手工 脚本 ， 那 么 它 就 
不 算 完 全 自动 化 。 特 别 值得 一 提 的 是 ， 全 自动 部 署 还 包括 自动 化 的 数 
据 库 部 署 。 


我 见 过 许多 团队 声称 自己 有 自动 化 部 署 ， 结 果 发 现 需要 有 人 在 之 
后 手动 运行 数据 库 脚本 。 

全 自动 部 署 还 可 以 带 来 其 它 好 处 ， 比 如 可 以 更 容易 地 升级 生产 环 
境 。 长 远 来 看 ， 这 将 为 你 节省 大 量 的 时 间 。 不 管 是 否 使 用 实例 化 需求 
说 明 ， 频 每 部 署 都 是 一 个 非 溃 好 的 实践 。 
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适用 于 : 有 外 部 参考 数据 源 时 

许多 团队 处 理 业 务 流 中 的 外 部 参考 数据 产 或 外 部 系统 时 都 磁 到 了 
问题 (我 所 说 的 “外 部 ”是 指 超 出 团队 的 范围 ， 不 一 定 是 属于 不 同 组 织 
的 ) 。 大 型 企业 有 着 复杂 的 系统 网 络 ， 团 队 负 责 的 工作 流 可 能 只 是 系 
统 的 一 部 分 ， 而 测试 系统 则 需要 和 其 他 团队 的 测试 系统 相 沟 通 。 问 题 
是 其 他 团队 要 做 他 们 目 己 的 工作 和 测试 ， 所 以 他 们 的 测试 服务 器 不 可 
能 始终 保持 可 用 、 可 靠 并 且 正 确 。 

= 创建 一 个 单独 的 假 数据 源 来 模拟 与 真实 系统 的 交互 。 

Rob Park 的 团队 在 一 家 大 型 的 美国 保险 公司 工作 ， 他 们 构建 的 系 
统 需要 从 外 部 的 自动 策略 服务 器 查询 相关 策略 数据 。 如 果 自 动 策略 服 
务 器 当 机 了 ， 他 们 所 有 的 可 执行 需求 说 明 融 会 失败 。 对 于 功能 测试 ， 
他 们 使 用 了 一 个 外 部 服务 的 人 珍 代 版 本 。 这 个 版 本 更 加 简单 ， 可 以 从 本 
地 磁盘 上 的 文件 读 取 数据 。 

这 让 Park 的 团队 即使 在 自动 策略 服务 器 下 线 的 时 候 也 可 以 测试 他 
们 的 系统 。 创 建 一 个 单独 的 引用 数据 产 还 能 使 团队 完全 控制 系统 引用 
的 数据 。 而 且 真实 系统 无 法 提供 已 经 过 期 的 策略 ， 所 以 那些 依赖 于 过 
RATES AY Me A 

引用 数据 产 的 简化 版 本 从 配置 文件 里 提供 了 所 有 东西 ， 这 避免 了 
时 效 性 问题 。 他 们 把 数据 存放 在 一 个 XML 文 件 中 ， 并 将 其 签 入 到 版 本 
控制 系统 中 ， 这 样 他 们 就 可 以 很 容易 地 跟踪 改变 ， 并 能 够 把 相应 版 本 
的 测试 数据 和 代码 打包 在 一 起 。 而 外 部 系统 是 不 可 能 这 样 做 的 。 读 取 
文件 的 本 地 服务 也 比 外 部 系统 快 ， 使 得 整个 反馈 更 为 迅速 。 


使 用 测试 蔡 代 品 的 风险 是 真实 系统 会 随 着 时 间 演 化 ， 替 代 品 会 
法 反应 真实 的 功能 。 为 避免 这 个 问题 ， 要 确保 执行 阶段 性 检查 ， 看 看 
替代 品 是 否 像 原始 系统 一 样 工作 。 这 很 重要 ， 尤 其 是 当 奉 代 品 代表 着 
你 无 法 控制 的 第 三 方 系统 的 时 候 。 


10.1.6 j 地 隔 q 


适用 于 : 有 外 部 系统 参与 其 中 时 

完全 隔离 一 个 系统 的 做 法 并 不 见得 永远 适用 。 当 系统 参与 到 一 个 
更 大 的 工作 流 中 ， 外 部 系统 提供 的 不 再 仅仅 是 引用 数据 的 时 候 ， 测 试 
替代 品 就 必须 开始 实现 外 部 系统 的 部 分 真实 功能 。 这 会 带 来 巨大 的 开 
发 成 本 和 更 多 的 维护 问题 。 

在 Beazley，Ian Cooper 的 团队 采用 一 个 有 趣 而 实用 的 方法 解决 了 
这 个 问题 。 他 们 根据 每 个 可 执行 需求 说 明 的 目标 ， 选 择 性 地 禁止 访问 
某 些 服务 。 这 使 他 们 的 测试 速度 有 显著 的 提高 ， 但 是 每 个 测试 仍然 会 
涉及 一 些 必须 的 真实 外 部 系统 。 这 个 方案 并 没有 完全 帮 他 们 从 外 部 影 
响 中 解救 出 来 ， 但 是 这 使 故障 排除 简单 多 了 。 如 果 测 试 失 败 ， 可 以 很 
清楚 地 知道 哪些 外 部 依赖 影响 了 它 。 

— 选择 性 地 隔离 一 些 外 部 服务 可 以 让 测试 更 快 ， 故 障 排除 更 容 
易 。 


10.1.7 尝试 多 级 验证 

适用 于 : 大 型 、 多 级 组 织 

在 遗留 系统 中 ， 运 行 所 有 的 可 执行 需求 说 明 所 花 的 时 间 往 往 要 比 
两 次 提交 代码 修改 的 间隔 时 2 间 还 要 长 。 因 此 ， 将 某 个 问题 关联 到 导致 
该 问题 出 现 的 某 次 修改 可 能 是 比较 困难 的 。 

有 多 个 团队 的 时 候 ， 特 别 是 当 他 们 分 布 在 多 个 不 同 地 方 的 时 候 ， 
这 会 导致 问题 不 断 积累 。3 如 果 一 个 团队 破坏 了 数据 库 ， 那 么 其 他 的 团 
队 将 无 法 验证 他 们 的 修改 ， 直 到 问题 被 修复 。 发 现存 在 问题 、 确 定 是 
何 问 题 、 修 复 它 并 重新 运行 测试 以 确认 修复 成 功 ， 这 些 可 能 要 伦 上 数 
小 时 时 间 。 失 败 的 构建 总 是 别人 的 问题 ， 很 快 持续 验证 测试 将 总 是 
败 。 到 那 时 ， 我 们 可 能 就 会 停止 运行 测试 。 

~ 要 使 用 多 级 验证 。 每 个 团队 都 应 该 有 隔离 的 持续 验证 环境 ， 任 
何 变更 都 应 该 先 在 那里 进行 测试 。 

首先 要 整合 同一 个 团队 的 修改 。 如 果 测 试 通过 ， 则 把 修改 推送 到 
持续 验证 的 中 心 环境 中 ， 在 那里 与 其 他 团队 的 变更 进行 集成 。 

大 多 数 情况 下 ， 这 种 方法 可 以 防止 一 个 团队 的 问题 影响 到 其 他 团 
队 。 即 使 中 心 环 境 被 破坏 了 ， 有 人 正在 进行 修复 ， 各 个 团队 仍然 可 以 


使 用 他 们 自己 的 环境 来 验证 他 们 所 做 的 变更 。 

根据 运行 所 有 可 执行 需求 说 明 所 花 的 时 间 ， 我 们 可 以 选择 在 这 两 
种 环境 中 都 运行 所 有 的 测试 ， 或 者 只 在 其 中 一 个 环境 运行 一 部 分 典型 
的 测试 作为 一 次 快速 的 冒 烟 测 试 。 比 如 Ultimate 软件 公司 的 Global 
Talent Management 团 队 ， 他 们 的 测试 大 多 只 在 本 地 团队 环境 中 运行 。 
较 慢 的 测试 不 要 为 获得 快速 的 反馈 而 在 中 心 环 境 中 运行 。 

10.1.8 {Til 


适用 于 : 可 执行 需求 说 明 需 要 修改 引用 数据 时 

~ 数据 库 事务 可 以 隔离 外 界 的 影响 。 

事务 可 以 防止 我 们 的 进程 影响 到 其 他 正在 运行 的 进程 ， 并 提高 测 
试 的 可 重 现 性 。 

如 果 我 们 在 测试 中 创建 一 个 用 户 ， 那 么 下 次 我 们 运行 这 个 测试 的 
时 候 它 可 能 会 失败 ， 因 为 数据 库 中 存在 用 户 名 的 唯一 性 约束 。 如 果 我 
们 在 事务 中 运行 测试 ， 并 在 测试 最 后 进行 回 深 ， 那 么 用 尸 数 据 不 会 得 
到 保存 ， 两 次 测试 执行 会 是 独立 的 。 

在 许多 情况 下 这 是 一 个 不 错 的 实践 ， 但 是 在 某 些 事务 相关 的 上 下 
文中 (比如 如 果 数 据 库 的 约束 检查 延迟 到 事务 提交 之 后 ， 或 者 在 说 套 
的 自治 事务 中 ) ， 这 可 能 是 行 不 通 的 。 这 些 高 级 的 事务 话题 不 在 本 书 
的 讨论 沁 围 内 。 

任何 时 候 都 要 在 需求 说 明 外 部 控制 事务 。 数 据 库 事务 控制 是 一 个 
跨 领域 问题 ， 最 好 在 自动 化 层 实 现 ， 而 不 是 在 可 执行 需求 说 明 中 描 


述 。 


在 数据 驱动 的 系统 中 ， 可 执行 需求 说 明 广 泛 依 赖 于 引用 数据 。 对 
引用 数据 的 变更 (如 工作 流 配置 ) 即使 在 功能 正确 的 情况 下 也 有 可 能 
破坏 测试 ， 这 样 的 问题 很 难 解决 。 


~ 专门 设置 一 组 完全 独立 的 测试 来 验证 引用 数据 是 否 与 我 们 期 望 
的 一 致 。 

这 些 测试 可 以 在 可 执行 需求 说 明 运 行 之 前 快速 地 运行 。 如 果 这 些 
测试 失败 ， 就 没有 必要 运行 其 他 的 了 。 这 些 测 试 还 会 指出 引用 数据 的 
问题 ， 让 我 们 可 以 快速 地 进行 修复 。 
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10.1.10 等 和 


异步 过 程 似乎 是 可 执行 需求 说 明 中 问题 最 多 的 一 个 领域 。 甚 至 当 
一 个 过 程 的 一 部 分 在 后 台 执 行 、 运 行 在 不 同 的 机 器 上 ， 或 者 需要 数 小 
时 的 延迟 时 间 时 ， 商 业 用 户 依然 会 把 整个 过 程 看 成 是 单个 事件 序列 。 
在 Songkick， 这 是 他 们 成 功 实施 实例 化 需求 说 明 的 一 个 最 大 的 挑战 。 
Phil Cowans 说 : 

“异步 过 程 真 的 令 我 们 很 头疼 。 基 于 性 能 原因 ， 我 们 有 很 多 后 台 处 
理 过 程 是 异步 的 ， 而 由 于 测试 是 即时 运行 的 ， 我 们 碰 到 了 很 多 问题 。 
测试 进行 到 了 下 一 步 ， 而 后 台 处 理 还 未 执行 。” 

要 可 靠 地 验证 异步 过 程 ， 需 要 在 自动 化 层 (通常 是 在 生产 系统 
中 ) 进行 一 些 计 划 和 细心 的 设计 。 对 异步 系统 的 测试 ， 我 们 经 常会 见 
到 的 错误 是 花 一 定时 间 等 待 某 件 事情 发 生 。 症 状 之 一 是 存在 “等 待 10 
秒 ” 这 样 的 测试 步骤 。 出 于 几 方 面 的 原因 ， 这 样 做 很 糟糕 。 

即使 程序 功能 都 正常 ， 当 持续 验证 的 环境 负 蓓 较 大 的 时 候 ， 这 些 
测试 仍 可 能 会 失败 。 在 不 同 的 环境 中 运行 这 些 测 试 可 能 需要 更 多 的 时 
间 ， 因 此 它们 开始 依赖 于 特定 的 部 署 。 当 持续 验证 的 环境 比 开 发 人 员 
的 机 器 强劲 得 多 的 时 候 ， 在 同一 个 超时 配置 (Timeout Configuration) 
下 ， 开 发 人 员 的 机 器 就 无 法 去 验证 变更 。 许 多 团队 会 为 测试 设置 较 高 
的 超时 时 间 ， 以 使 测试 对 环境 变化 的 适应 力 更 强 。 于 是 这 些 测 试 产 生 
了 不 必要 的 反馈 延迟 。 

例如 ， 如 果 一 个 测试 无 条 件 地 花 一 分 钟 等 待 某 个 过 程 结束 ， 但 是 
那个 过 程 只 用 10 秒 就 完成 了 ， 我 们 就 产生 了 50 秒 钟 不 必要 的 反馈 延 
迟 。 较 短 的 延迟 对 单个 测试 可 能 不 成 问题 ， 但 是 它们 在 测试 包 中 会 累 


只 。 进 行 20 个 这 样 的 测试 ， 整 个 测试 的 反馈 就 会 延 运 15 分 钟 以 上 ， 这 
个 影响 就 很 大 了 。 

~ 去 等 待 一 个 事件 的 发 生 ， 而 不 要 等 待 一 段 时 间 的 流逝 。 这 会 使 
测试 可 靠 得 多 ， 而 且 不 会 造成 不 必要 的 反馈 延迟 。 

可 能 的 话 ， 让 这 些 测试 去 阻塞 消息 队列 ， 或 频繁 轮 询 数 据 库 (或 
后 人 台 服 务 ) ， 以 检查 处 理 过 程 是 否 已 经 完成 。 


s 


10.1.11 h A 


适用 于 : 新 项 目 

从 零 开 始 构建 一 个 系统 的 时 候 ， 我 们 可 以 将 其 设计 成 容易 进行 测 
试 。 根 据 配 置 ， 系 统 可 以 在 队列 中 添加 一 个 消息 以 便 让 后 台 去 处 理事 
务 ， 或 者 也 可 以 直接 执行 它 。 我 们 可 以 配置 持续 验证 环境 来 同步 执行 
所 有 的 过 程 。 

~ 有 个 提高 测试 稳定 性 的 好 方法 ， 就 是 将 异步 处 理 作 为 一 个 可 选 
项 。 

这 个 方法 可 以 让 可 执行 需求 说 明 运 行 得 更 快 更 可 靠 。 但 是 这 也 意 
味 着 功能 测试 不 会 端 到 端 地 检查 系统 。 如 果 你 在 功能 测试 中 关闭 了 异 
步 处理 ， 要 记得 编写 额外 的 技术 测试 来 验证 异步 处 理 是 否 正常 工作 。 
虽然 听 起 来 这 可 能 使 工作 量 加 倍 了 ， 但 实际 上 却 并 非 如 此 。 技 术 测 试 
可 以 比较 短小 ， 而 且 可 以 只 专注 于 技术 协调 ， 无 需 验 证 业务 功能 ( 业 
务 功 能 将 单独 在 功能 测试 中 检查 ) 。 

还 有 一 些 很 好 的 自动 化 验证 异步 处 理 的 技术 方案 ， 可 以 参考 
Growing Object Oriented Software, Guided by Tests 一 书 。 


许多 团队 ， 特 别 是 在 现存 的 遗留 系统 上 工作 的 团队 ， 既 用 可 执行 
需求 说 明 做 功能 测试 ， 又 用 它 做 端 到 端的 集成 测试 。 这 使 他 们 更 加 自 
信和 软件 整体 上 工作 正常 ， 但 是 反馈 却 慢 了 很 多 ， 并 且 显 著 增加 了 测试 
的 维护 成 本 。 


这 么 做 的 问题 在 于 它 同时 测试 了 太 多 东西 。 这 样 的 端 到 端 测试 会 
检查 过 程 的 业务 逻辑 、 与 技术 搬 层 的 集成 情况 以 及 所 有 组 件 之 间 能 否 
互相 通讯 。 活 动 部 件 太 多 意味 着 其 中 任意 部 分 的 改变 将 会 导致 测试 失 
败 。 这 还 意味 着 即使 我 们 只 想 测试 整个 过 程 的 一 小 部 分 ， 我 们 也 不 得 
不 端 到 端 地 运行 整个 过 程 来 验证 每 种 情况 。 

= 不 要 在 一 个 大 的 可 执行 需求 说 明 中 同时 测试 太 多 东西 。 

大 多 数 异 步 过 程 由 几 个 步骤 组 成 ， 每 个 步骤 都 有 一 些 业务 逻辑 ， 
这 些 逻 辑 需 要 用 可 执行 需求 说 明 来 定义 。 它 们 大 多 还 包括 一 些 单纯 的 
技术 任务 ， 比 如 分 发 到 一 个 队列 ， 或 者 保存 到 数据 库 。 与 其 使 用 一 个 
较 大 的 可 执行 需求 说 明 花 很 长 时 间 去 检查 所 有 事情 ， 倒 不 如 在 实施 这 
个 过 程 的 时 候 考虑 一 下 以 下 想法 。 

明确 分 离 业 务 逻 辑 和 底层 代码 (例如 ， 加 入 到 一 个 队列 、 写 入 数 
HEIE) o 

如 本 章 之 前 所 说 的 ， 分 别 说 明 并 测试 每 个 步骤 中 的 业务 逻辑 ， 如 
果 可 能 的 话 隔 离 底 层 代码 。 这 会 让 编写 和 运行 测试 简单 得 多 。 测 试 可 
以 同步 运行 ， 它 们 不 需要 和 真实 的 数据 库 或 真实 的 队列 进行 交互 。 这 
些 测试 能 让 你 确信 是否 正 确 地 实现 了 业务 逻辑 。 

为 底层 代码 、 队 列 或 数据 库 实现 的 仓库 编写 技术 集成 测试 。 这 些 
测试 可 以 很 简单 ， 因 为 它们 不 需要 验证 复杂 的 业务 逻辑 。 它 们 可 以 让 
你 确信 是 否 正确 地 使 用 了 底层 设施 。 

编写 一 个 端 到 端的 集成 测试 去 验证 所 有 组 件 都 能 正确 地 进行 交 
互 。 可 以 执行 一 个 简单 的 业务 场景 ， 它 必须 涉及 所 有 的 组 件 ， 比 如 阻 
塞 一 个 队列 等 待 响应 ， 或 者 轮 询 数据 库 检 查 结果 。 这 可 以 让 你 确信 配 

是 否 正常 。 如 果 你 使 用 高 层次 的 例子 ， 束 像 5.2.3 市 中 建议 的 ， 那 么 
它们 会 是 不 错 的 候选 测试 。 

从 底层 业务 逻辑 的 测试 到 端 到 端的 测试 ， 一 般 我 期 望 看 到 的 是 测 
试 数目 逐步 碱 少 ， 而 执行 单个 测试 的 时 间 则 显著 增加 。 通 过 把 复杂 的 
业务 逻辑 从 底层 中 剥离 出 来 ， 我 们 就 能 提高 可 靠 性 。 


10.2 获得 更 快 的 反馈 


大 多 数 团 队 都 会 发 现 ， 每 次 系统 改变 后 都 执行 所 有 的 可 执行 需求 
说 明 不 太 现 实 。 如 果 测 试 包含 大 量 的 检查 (特别 是 这 些 检查 只 能 对 网 
站 、 数 据 库 或 外 部 服务 运行 时 ) ， 那 么 从 完整 的 测试 执行 中 获得 反馈 
就 太 慢 了 。 为 了 更 有 效 地 支持 开发 并 辅助 变更 ， 大 多 数 团 队 都 对 他 们 
的 持续 验证 系统 进行 了 改动 ， 以 便 提 供 分 阶段 的 反馈 ， 这 样 他 们 就 能 
更 快 地 得 到 最 重要 的 信息 。 这 里 有 一 些 我 采访 过 的 团队 使 用 的 策略 ， 
它们 能 有 效 缩短 反馈 时 间 。 

10.2.1 业务 时 站 


适用 于 : 有 时 间 约 束 时 

时 间 | 约 束 是 自动 化 功能 测试 反馈 慢 的 一 个 党 见 原因 。 通 常 ， 每 天 
结束 后 的 任务 (job) 可 能 会 放 到 半夜 运行 ， 任 何 依赖 于 它们 的 测试 都 会 
产生 较 慢 的 反馈， 因为 我 们 必须 平均 等 上 12 个 小 时 才能 看 到 结果 。 缓 
存 头 (Cache headers) 可 能 会 影响 一 个 文档 是 否 从 后 台 获 取 ， 要 正确 测试 
这 个 功能 我 们 可 能 需要 等 上 几 天 才能 得 到 结果 。 

这 个 问题 有 个 很 好 的 解决 方案 ， 那 就 是 在 系统 中 引入 业务 时 间 的 
概念 ， 它 是 一 个 可 配置 的 上 时间， 可 以 代 蔡 系统 时 间 。 

-= 当 系 统 需要 获取 当前 时 间或 日 期 的 时 候 应 该 使 用 这 个 业务 时 
钟 。 这 让 我 们 可 以 在 测试 进行 的 时 候 很 容易 穿 权 于 各 个 时 间 之 间 。 这 
会 增加 一 点 系统 的 复杂 度 ， 但 是 它 可 以 让 我 们 的 测试 快 很 多 。 

实现 业务 时 间 有 个 快速 丑陋 的 方式 是 在 测试 环境 自动 修改 时 间 ， 
这 并 不 需要 改变 设计 。 注 意 有 些 应 用 会 缓存 时 间 ， 因 此 当 系 统 时 间 更 
新 后 它们 可 能 需要 重启 。 如 果 其 他 地 方 也 在 使 用 这 个 时 间 ， 比 如 ， 在 
测试 执行 报告 中 ， 那 么 修改 系统 时 间 可 能 会 让 测试 结果 更 难 理解 。 一 
个 更 好 的 方案 是 在 生产 软件 中 增加 业务 时 间 的 功能 。 

引入 业务 时 间 还 可 以 解决 过 期 数据 的 问题 。 举 例 来 说 ， 使 用 即将 
过 期 的 合同 进行 测试 在 6 个 月 之 内 可 能 一 直 正 常 工作 ， 然 后 当 合 同 过 期 
时 就 突然 开始 失败 了 。 如 果 系 统 支持 修改 业务 时 间 ， 我 们 就 可 以 保证 
这 些 合同 永远 不 会 过 期 ， 以 此 减少 维护 成 本 。 


引入 业务 时 间 的 潜在 风险 是 当 系 统 需要 同 我 们 不 能 影响 的 外 部 系 
统 进行 通讯 时 ， 会 引 友 时 间 的 同步 问题 。 要 解决 这 个 问题 ， 请 使 用 本 
章 之 前 讲 到 的 测试 人 符 代 品 或 采用 隔离 的 方法 。 


在 构建 可 执行 需求 说 明 数 月 乃至 数 年 之 后 ， 许 多 团队 的 测试 包 需 
要 运行 数 小 时 。 因 为 有 数 以 百 计 的 测试 要 执行 ， 所 以 大 家 会 想当然 地 
认为 反馈 慢 是 很 正常 的 。 他 们 不 会 注意 到 有 些 测试 比 以 往 多 花 了 20 
钟 。 这 些 问题 会 快速 累积 ， 而 反馈 就 需要 更 长 时 间 了 。 

= 相 比 需要 运行 6 个 小 时 的 一 组 大 的 可 执行 需求 说 明 ， 我 更 希望 运 
行 12 组 较 小 的 测试 ， 每 个 花费 不 到 30 分 钟 的 运行 时 间 。 通 常 ， 我 会 把 
这 些 测试 按 功 能 分 解 。 

比方 说 ， 如 果 我 要 解决 一 个 会 计 子 系统 的 问题 ， 我 只 需 快 速 地 重 
新 运行 会 计 相关 的 测试 就 可 以 检查 问题 是 不 是 已 经 解决 。 我 不 必 花 费 6 
个 小 时 去 等 待 所 有 其 他 测试 的 完成 。 

如 果 某 一 组 测试 的 执行 时 间 突 然 增加 了 10 分 钟 ， 我 通过 查看 特定 
测试 组 的 测试 历史 ， 很 容易 就 能 发 现 这 一 点 。 与 半 个 小 时 增加 10 分 钟 
相 比 ，6 个 小 时 增加 10 分 钟 没 那么 容易 察觉 。 这 可 以 让 反馈 延 时 保持 在 
可 探 的 沁 围 内 ， 因 为 我 会 开始 想 办 法 优化 特定 的 测试 组 。 最 近 ， 通 过 
将 一 个 很 大 的 测试 组 分 解 成 几 个 较 小 的 测试 组 ， 我 帮助 一 个 客户 意识 
到 ， 只 有 一 个 功能 领域 会 导致 很 长 的 延 时 。 我 们 把 将 近 一 个 小 时 的 时 
间 降 低 到 了 仅仅 9 分 钟 。 这 融 是 “分 而 治之 ”的 妙 处 ! 


为 了 加 快 反 馈 ， 有 些 团队 做 数据 驱动 系统 的 时 候 会 把 持续 验证 测 
试 运行 在 内 存 数据 库 上 而 不 是 真实 的 数据 库 上 。 这 样 系统 仍然 可 以 执 
行 SQL 代码 ， 但 这 会 让 所 有 的 SQL 调用 运行 得 快 很 多 。 这 也 可 以 更 好 
地 隔离 测试 的 运行 ， 因 为 每 个 测试 可 以 用 各 自 的 内 存 数 据 库 来 运行 。 
但 实际 上 许多 团队 发 现 ， 长 远 来 看 像 这 样 运行 测试 成 本 会 高 于 它 所 讳 
来 的 收益 。 

包括 数据 库 部 分 的 可 执行 需求 说 明 很 像 功能 验收 测试 ， 同 时 又 很 
像 端 到 端的 集成 测试 。 编 写 这 种 测试 的 人 一 般 还 需要 检查 SQL 语 句 的 
执行 。 只 要 真实 的 生产 数据 库 和 内 存 数 据 库 实行 之 间 存 在 着 细微 的 
SQL 语言 差别 ， 就 可 能 导致 错误 的 测试 结果 。 这 种 方法 往往 还 需要 维 
护 两 套 SQL 文件 ， 并 且 两 个 地 方 都 需要 进行 数据 变更 的 管理 。 

— 如果 你 使 用 内 存 数 据 库 ， 端 到 端的 集成 测试 就 会 去 验证 系统 是 
否 能 在 内 存 数 据 库 (而 不 是 你 在 生产 环境 中 用 的 真实 数据 库 ) 上 工作 
正常 。 

我 之 前 提 到 过 一 些 更 好 的 解决 方案 可 以 解决 这 个 问题 。 在 事务 中 
运行 测试 可 以 提供 更 好 的 隅 离 性 。 混 合 端 到 端的 集成 测试 和 功能 验收 


测试 可 能 不 是 一 个 最 好 的 主意 (如 本 章 之 前 所 提 到 的 ) ， 但 是 如 果 你 
真 要 这 么 做 ， 那 么 请 使 用 真实 的 数据 库 ， 并 想 办 法 提高 它 的 速度 。 

爱 荷 华 州 助 学 贷 款 公司 的 团队 使 用 了 内 存 数据 库 做 测试 ， 但 是 后 
来 他 们 又 放弃 7 了。Tim Andersen 说 : 

“我 们 使 用 SQL Server 作 为 数据 库 ， 并 使 用 Hypersonic 代 替 它 运行 
在 内 存 中 。 这 为 我 们 45 分 钟 一 次 的 构建 过 程 节约 了 2 分 钟 。 一 旦 我 们 在 
数据 库 中 添加 了 索引 ，SQL Server 确 实 更 快 了 。Hypersonic 需 要 更 多 
的 维护 ， 但 它 又 没有 加 快 多 少 构建 时 间 。>” 

如 果 测 试 在 真实 数据 上 运行 得 很 慢 ， 那 就 意味 着 系统 在 生产 环境 
中 运行 可 能 也 会 很 慢 ， 因 此 提高 测试 数据 库 的 性 能 从 长 远 计 划 来 说 也 
是 有 意义 的 。 注 意 这 条 建议 只 适用 于 数据 驱动 的 系统 ， 这 样 的 系统 上 
经 常 需要 执行 特定 的 数据 库 代 码 。 使 用 内 存 数据 库 来 加 速 不 确定 数据 
库 的 检查 可 能 会 是 非常 好 的 解决 方案 。 

10.2.4 把 快速 的 和 缓慢 的 测试 分 开 

适用 于 : 一 小 部 分 测试 占用 了 整个 测试 的 大 部 分 执行 时 间 时 

-> 如 果 一 小 部 分 测试 的 运行 时 间 占 据 了 整个 测试 的 大 部 分 时 间 ， 
那么 只 去 频繁 地 运行 那些 较 快 的 测试 也 许 是 个 不 错 的 主意 。 

许多 团队 将 他 们 的 可 执行 需求 说 明 根 据 执行 速度 分 成 2~3 组 。 比 
方 说 在 RainStor， 为 了 检查 系统 的 性 能 ， 运 行 有 些 测 试 需要 非常 大 的 
数据 量 。 他 们 有 一 组 功能 测试 每 次 构建 都 会 运行 ， 所 需 时 间 不 到 1 个 小 
时 。 到 晚上 ， 他 们 还 会 使 用 从 客户 那里 得 来 的 真实 数据 来 运行 客户 场 
景 。 他 们 每 个 周末 运行 一 次 耗 时 很 长 的 测试 。 虽 然 这 种 方法 不 能 每 次 
都 提供 完整 的 验证 ， 但 这 能 显著 降低 变更 引入 问题 的 风险 ， 同 时 还 能 
提供 相对 较 快 的 反馈 。 

10.2.5 间 况 

适用 于 : 缓慢 的 测试 只 在 夜间 执行 时 

延迟 执行 缓慢 的 测试 有 个 比较 严重 的 问题 ， 那 就 是 无 法 很 快 地 发 
现 和 修复 这 些 测 试 中 存在 的 问题 。 如 果 夜 间 执 行 的 测试 包 失 败 了 ， 我 


们 到 早上 发 现 后 试 着 去 修复 问题 ， 然 后 要 到 下 一 个 早上 才能 得 到 结 
果 。 这 么 慢 的 反馈 会 使 夜晚 构建 经 常 失败 ， 而 这 会 掩盖 白天 引入 的 其 
他 问题 。 

= 只 把 不 容易 失败 的 测试 放 到 夜晚 执行 。 

为 了 保持 夜间 测试 的 稳定 性 ， 可 以 把 失败 的 测试 加 入 到 另 一 个 测 
试 包 中 (参考 本 章 稍 后 面 的 10.3.1 节 ) 。 

另外 一 个 方法 是 只 把 那些 已 经 可 以 稳定 通过 的 测试 加 入 到 夜间 测 
试 包 中 。 测 试 运行 的 历史 统计 数据 (本 章 前 面 讨 论 过 ) 可 以 帮助 我 们 
判断 测试 是 否 已 经 足够 好 ， 可 以 放 入 到 夜间 测试 包 中 。 

如 果 这 些 测试 太 慢 而 不 能 持续 地 执行 ， 有 个 可 能 的 办 法 是 将 它们 
周期 性 地 按 需 执行 ， 直 到 它们 变 得 足够 稳定 可 以 延期 执行 。RainStor 
的 Adam Knight 使 用 了 这 样 的 策略 : 

“手动 执行 测试 ， 直 到 它们 足够 稳定 ， 然 后 再 放 入 到 夜间 测试 包 中 
执行 。 把 测试 分 开 可 以 给 我 们 带 来 许多 方面 的 好 处 。 如 果 测 试 失败 ， 
我 们 就 修复 它 。 严 重 的 测试 失败 会 成 为 我 们 的 最 高 优先 级 。>” 

只 在 测试 不 太 可 能 失败 的 情况 下 ， 才 把 需求 说 明 加 入 到 夜间 测试 
包 中 ， 通 过 这 种 方法 ，RainStor 的 团队 降低 了 慢 反 馈 测试 失败 的 风 
险 ， 这 时 候 失 败 是 由 于 功能 还 处 于 开发 过 程 中 。 这 显著 地 降低 了 夜间 
测试 包 的 维护 成 本 。 它 们 还 是 会 捕捉 到 没有 想到 或 无 法 预计 的 改变 ， 
虽然 这 种 情况 很 少见 。 考 虑 到 这 一 点 ， 为 了 降低 维护 成 本 ， 这 些 功 能 
的 慢 速 反馈 是 一 种 很 好 的 折 中 做 法 。 


夜晚 移动 © ARE 


10.2.6 前 ; —‘ ill 


将 运行 时 间 较 长 的 测试 分 割 成 较 小 的 测试 包 有 一 个 常见 的 特殊 情 
况 ， 那 就 是 为 当前 的 迭代 创建 测试 包 。 这 个 测试 包 包 括 当 前 开发 阶段 
会 影响 的 可 执行 需求 说 明 。 

- 当前 迭代 的 变更 ， 会 影响 系统 中 最 不 稳定 和 最 重要 的 部 分 ， 清 
晰 地 划分 出 当前 迭代 测试 包 可 以 让 我 们 快速 地 获得 有 关 这 部 分 反馈 。 

如 果 我 们 把 当前 迭代 的 测试 包 从 其 他 测试 中 拆 分 出 来 ， 那 么 即使 
是 针对 于 那些 已 计划 而 尚未 实现 的 功能 而 编写 的 测试 ， 我 们 也 可 以 放 
心地 将 它们 加 入 进来 。 运 行当 前 迭代 的 所 有 测试 可 以 让 我 们 更 容易 地 
跟踪 开发 进度 ， 准 确 地 了 解 我 们 何 时 可 以 完成 。 大 部 分 时 候 ， 当 前 迭 
代 的 测试 包 可 能 会 整体 失败 ， 但 是 这 并 不 会 影响 主要 的 回归 验证 。 

如 果 我 们 需要 更 为 频繁 地 验证 这 些 需求 说 明 ， 那 么 可 以 变通 地 使 
用 这 种 方法 ， 那 就 是 为 当前 发 布 创建 一 个 测试 包 。 注 意 许多 自动 化 工 
具 人 多 许 我 们 创建 并 行 的 层次 结构 ， 如 此 一 来 同样 的 需求 说 明 可 以 同时 
隶属 于 多 个 不 同 的 测试 包 。 

10.2.7 并 行 运行 疯 


适用 于 : 拥有 多 套 测 试 环境 时 


-如果 你 在 公司 有 权 建 立 多 套 测试 环境 ， 那 么 只 要 你 把 大 的 测试 
包 分 割 成 多 个 小 的 集 舍 ， 你 就 可 以 试 着 并 行 运行 它们 。 这 会 让 你 获取 
到 最 快 的 反馈 。 

如 果 有 些 测试 必须 隔离 运行 ， 不 能 并 行 执行 ， 那 么 可 以 把 它们 也 
分 割 到 一 个 单独 的 集合 中 。 在 LMAX，jodie Parker 是 这 样 组 织 持续 集 
成 和 验证 的 : 

“提交 构建 (Commit Build) 在 3 分 钟 内 就 可 运行 完 所 有 的 单元 测试 
并 进行 状态 分 析 。 如 果 通 过 了 ， 顺 序 执行 的 环境 会 执行 需要 独立 运行 
的 或 不 能 并 行 运行 的 测试 。 然 后 23 个 虚拟 机 会 并 行 运行 验收 测试 。 在 
这 之 后 ， 性 能 测试 就 开始 执行 。 它 们 (可 执行 需求 说 明 ) 一 般 运 行 8 一 
20 分 钟 。 

最 后 ， 如 果 一 定数 量 的 测试 通过 了 ， 我 们 会 部 署 一 个 QA 环境 运行 
冒 烟 测 试 和 探索 测试 ， 并 给 开发 人 员 提 供 反 馈 。 如 果 提 交 构 建 失败 
了 ， 大 家 就 得 停 下 来 (一 项 完全 的 禁令 ) 将 其 修复 。>” 

如 果 你 们 对 安全 不 那么 敏感 ， 或 者 工作 中 没有 监管 约束 阻止 你 们 
把 代码 部 署 到 组 织 外 ， 那 么 新 兴 的 云 计算 服务 可 以 帮助 你 运行 并 行 测 
试 。 远 程 部 署 代码 会 花 一 些 时 间 ， 但 是 这 可 以 让 你 同时 在 大 量 的 机 器 
上 运行 测试 。 在 Songkick， 他 们 使 用 亚马逊 的 EC2 云 来 运行 验收 测 
Itt. Phil Cowans 说 这 帮助 他 们 大 幅 降低 了 构建 时 间 : 

“在 单个 机 器 上 运行 完整 测试 需要 3 个 小 时 ， 但 是 我 们 采用 并 行 
行 的 方法 。 我 们 刚刚 学 习 了 如 何在 EC2 上 执行 测试 ， 把 时 间 缩 短 到 20 
分 钟 。 i 

有 些 持 续 构 建 系统 ， 比 如 TeamCity ， 已 经 提供 了 在 EC2 上 执行 
测试 的 标准 功能 。 这 让 我 们 可 以 更 加 简单 地 使 用 云 计算 进行 持续 验 
证 。 还 有 些 新 兴 服 务 通过 云 服务 提供 自动 化 ， 比 如 Sauce Labs 就 值得 
bs 


注释 : (Dhttp://www.jetbrains.com/teamcity 


10.2.8 禁 È il 


适用 于 : 测试 反馈 非常 慢 时 

uSwitch 的 团队 对 运行 时 间 较 长 、 反 馈 较 慢 的 测试 包 有 其 独特 的 处 
理 方式 。 一 旦 相关 功能 实现 后 ， 他 们 就 会 禁用 与 之 对 应 的 风险 较 低 的 
Mito Damon Morgan 说 : 

“有 时 候 ， 你 编写 的 验收 测试 (用 来 驱动 开发 非常 好 用 ) 一 旦 在 功 
能 开发 完成 后 就 不 太 重 要 了 。 有 些 东 西 并 不 赚钱 (比如 ， 发 送 延 迟 的 
邮件 ) ， 这 不 是 网 站 很 核心 的 部 分 ， 只 是 附加 的 一 些 功能 .…... 它 们 
(可 执行 需求 说 明 ) 可 以 很 好 地 帮助 我 们 驱动 开发 ， 但 是 之 后 持续 地 
将 它们 作为 回归 测试 来 运行 对 我 们 并 没有 什么 太 大 的 用 处 。 维 护 它们 
比 直接 扔 掉 繁琐 多 了 。 在 我 们 的 代码 控制 系统 中 的 确 有 一 些 测试 是 不 
会 运行 的 。 当 我 们 需要 扩展 功能 的 时 候 ， 我 们 依然 可 以 去 修改 已 有 的 
Miz. ” 

对 我 来 说 ， 这 是 一 个 很 有 争议 的 做 法 。 我 认为 如 果 一 个 测试 值得 
运行 ， 那 就 值得 一 直 运 行 下 去 。 


注释 : GD 其实 ， 我 是 从 David Evans 那 儿 得 到 的 这 个 想法 。 所 以 如 
果 你 想 引 用 ， 请 把 David 作 为 引用 出 处 。 


在 uSwitch， 大 多 数 测试 是 通过 网 页 用 户 界面 运行 的 ， 所 以 它们 需 
要 很 长 的 运行 时 间 ， 维 护 成 本 也 很 高 ， 正 是 这 个 原因 驱使 它们 采用 了 
这 种 方法 。 对 于 一 个 没 必要 总 是 运行 端 到 端 测试 的 系统 ， 我 更 喜欢 尝 
试 不 同 的 方法 去 进行 测试 自动 化 ， 这 样 它们 的 成 本 就 不 会 很 高 (请 参 
考 9.3.6 节 ) 。 

uSwitch 可 以 选择 禁用 测试 的 一 个 原因 是 他 们 有 单独 的 系统 在 监控 
着 他 们 生产 网 站 的 用 户 体 3 验 ， 该 系统 能 侦 测 出 网 站 用 户 是 否 看 到 错误 
或 者 某 个 特定 功能 的 使 用 率 是 否 突然 下 降 。 

讲 完 了 更 快 的 反馈 和 更 可 靠 的 验证 结果 后 ， 现 在 该 处 理 更 具 争 议 
性 的 问题 了 。 许 多 团队 开始 4 意识 到 ， 随 着 活 文档 系统 的 增长 ， 他 们 偶 
尔 还 是 要 忍受 失败 的 测试 。 在 下 一 小 节 ， 我 会 介绍 一 些 好 的 方法 来 处 
理 那 些 不 大 容易 马上 修复 的 失败 测试 。 


10.3 il 


在 Bridging the Communication Gap 一 书 中 ， 我 说 过 失败 的 测试 不 
应 该 直接 茜 掉 ， 而 应 该 马上 修复 。 在 为 本 书 做 完 调研 后 ， 我 略微 改变 
了 我 的 看 法 。 有 些 团 队 在 持续 验证 中 拥有 成 百 上 千 个 检查 ， 这 些 检查 
会 验证 伦 了 数 年 才 构 建 出 来 的 功能 。 从 Pierre Veragen 那 里 得 知 ， 
Weyerhaeuser 的 计算 引擎 系统 (第 1 章 提 到 过 ) 一 直 由 30000 多 个 检查 
持续 验证 着 。 

频繁 验证 这 么 多 的 需求 说 明 会 发 现 许多 问题 。 另 一 方面 ， 运 行 这 
么 多 的 检查 往往 意味 着 反馈 很 慢 ， 所 以 问题 不 会 马上 被 发 现 或 解决 。 
有 些 问 题 可 能 还 需要 商业 用 户 的 澄清 ， 或 者 它们 的 优先 级 相 比 当 前 和 迭 
代 将 要 上 线 的 功能 可 能 会 来 得 低 ， 所 以 我 们 没 必 要 在 发 现 这 些 问 题 后 
马上 就 全 部 修复 它们 。 

这 意味 着 持续 验证 中 有 些 测试 会 失败 ， 并 且 会 失败 一 段 时 间 。 当 
测试 包 失 败 的 时 候 ， 人 们 往往 不 会 去 寻找 它们 可 能 导致 的 其 他 问题 ， 
所 以 将 这 些 测试 置之不理 也 不 是 个 好 办 法 。 以 下 是 一 些 对 系统 的 功能 
性 回归 测试 进行 管理 的 窑 门 。 


建 了 预期 会 失败 的 测试 的 测试 包 。 

> 当 你 发 现 回 归 测 试 失败 了 ， 并 且 你 不 决定 马上 去 进行 修复 ， 那 
么 请 把 相关 测试 加 入 到 单独 的 集 舍 中 ， 这 样 即 使 测试 失败 了 也 不 会 影 
响 主要 的 验证 集 舍 。 

把 失败 的 测试 单独 放 在 一 起 可 以 让 我 们 跟踪 此 类 问题 的 数量 ， 防 
止 对 暂时 失败 的 “故意 放松 ?规则 成 为 导致 问题 堆积 的 “免费 出 狱 ” 卡 。 

单独 的 集合 还 能 让 我 们 阶段 性 地 运行 所 有 失败 的 测试 。 即 使 测试 
和 失败， 它们 还 是 值得 运行 的 ， 因 为 这 可 以 检查 是 否 有 其 他 的 失败 。 在 
RainStor， 他 们 把 这 些 测试 标记 为 缺陷 ， 但 是 他 们 仍然 会 执行 这 些 测 
试 以 便 进行 进一步 的 功能 回归 检查 。Adam Knight 说 : 

“可 能 某 天 由 于 ‘尾随 零 ; 导 致 测试 失败 了 。 如 果 第 二 天 测试 还 是 失 
败 了 ， 你 可 能 就 不 想 检 查 它 了 ， 因 为 你 已 经 知道 测试 失败 了 。 但 是 它 
也 可 能 返回 完全 错误 的 计算 结果 。” 

失败 的 回归 测试 包 有 个 潜在 的 风险 ， 就 是 它 可 能 会 在 交付 阶段 晚 
期 成 为 质量 问题 的 “免费 出 狱 * 卡 。 请 仅仅 将 已 知 失 败 的 测试 包 作 为 临 
时 空间 使 用 ， 用 来 存放 需要 进一步 查 明 的 问题 。 无 法 及 时 发 现 问题 是 
过 程 有 潜在 问题 的 警告 标志 。 避免 沙 入 这 种 陷阱 ， 有 个 较 好 的 策略 是 
限制 加 入 已 知 失 败 回 归 测 试 包 的 测试 数量 。 有 些 工 具 ， 比 如 
Cucumber， 甚 至 支持 目 动 检查 这 样 的 限制 。 

创建 单独 的 测试 包 去 收集 所 有 失败 的 测试 ， 从 项 目 管理 的 角度 来 
说 是 好 的 ， 因 为 我 们 可 以 对 其 进行 监控 ， 并 且 在 增长 过 快 时 采取 措 
施 。 一 两 个 并 不 重要 的 问题 可 能 无 须 中 止 产品 的 发 布 ， 但 是 如 果 这 个 
集合 增长 到 几 十 个 测试 ， 那 么 就 应 该 停 下 来 做 整顿 ， 以 免 场面 失控 。 
如 果 有 测试 在 已 知 失败 回归 测试 包 里 放 了 很 长 时 间 ， 那 就 说 明 这 个 测 
试 相 关 的 功能 可 以 去 择 了 ， 因 为 没有 人 关心 这 个 功能 。 

10.3.2 自动 检查 那些 被 禁用 的 涡 


适用 于 : 失败 测试 被 禁用 ， 却 没有 挪 到 单独 的 集合 中 时 

有 些 团 队 不 会 把 失败 的 测试 挪 到 单独 的 集合 中 ， 但 是 他 们 会 茶 
那些 测试 ， 这 样 已 知 的 失败 测试 就 不 会 再 破坏 整个 验证 过 程 。 这 种 方 
法 的 问题 是 很 容易 遗 扎 这些 被 禁用 的 测试 。 

单独 的 测试 包 让 我 们 能 监控 问题 并 确保 它们 最 终 被 修复 ， 或 者 我 
们 在 问题 修复 前 无 需 再 浪费 时 间 去 研究 类 似 的 问题 。 我 们 不 能 简单 地 
把 这 些 测试 禁用 。 另 外 的 问题 是 可 能 有 人 禁用 了 高 优先 级 的 失败 测 
试 ， 但 他 并 不 知道 这 个 问题 应 该 马上 修复 。 

-如果 你 有 禁用 的 测试 ， 请 自动 监控 它们 。 

爱 答 华 州 助 学 贷 款 公司 的 团队 有 个 自动 化 测试 会 检查 哪些 测试 被 
禁用 了 。Tim Andersen 说 : 

“人 们 禁用 测试 ， 是 因为 我 们 需要 一 个 决定 ， 或 者 我 们 在 编写 新 的 
测试 ， 不 确定 旧 的 测试 需要 如 何 进行 调整 。 可 能 没有 人 再 继续 跟 进 讨 
论 了 ,或 者 大 家 只 是 志 记 了 重新 启用 这 些 测试 。 有 时 测试 被 禁用 是 因 
为 大 家 还 在 编写 这 个 测试 ， 还 没有 具体 的 测试 代码 。 

我 们 使 用 FitNesse 寻 找 禁 用 的 测试 ， 我 们 有 一 个 页 面 专 门 检查 所 
有 的 测试 名 称 。 我 们 用 它 罗 列 出 被 有 意 禁 用 的 测试 ， 并 在 JIRA (缺陷 
跟踪 系统 ) 中 增加 一 项 记录 。 所 以 禁用 列表 相当 于 另 一 个 测试 。 它 必 
须 与 你 想 禁 用 的 测试 相 匹 配 。 在 迭代 最 后 ， 我 们 会 查看 这 些 禁 用 的 测 
试 。 我 们 可 能 会 说 : “这 个 测试 不 再 有 用 ， 把 它 删 了 吧 。: 或 者 ，' 哦 ， 
这 里 有 个 特殊 情况 ， 我 们 还 没有 从 业务 人 员 那 里 得 到 反馈 。 TRE 
况 下 ， 我 们 必须 修复 测试 。” 

如 果 你 决定 临时 禁用 失败 的 测试 ， 而 不 是 把 它们 挪 到 一 个 单独 的 
集合 中 ， 那 么 请 确保 你 可 以 1 很 容易 地 对 它们 进行 监控 ， 防 止 大 家 遗忘 
这 些 被 禁用 的 测试 。 否 则 ， 你 构建 的 活 文档 系统 将 会 很 快 过 时 。 蔡 
可 执行 需求 说 明 是 处 理 测 试 失 败 的 一 个 快速 而 丑陋 的 临时 解决 方案 ， 
但 这 对 于 持续 验证 的 整体 来 说 是 有 益 的 。 

一 旦 我 们 持续 验证 了 需求 说 明 ， 从 功能 角度 判断 系统 在 做 什么 就 
变 得 容易 了 ， 人 至 少 对 于 可 执行 需求 说 明 覆 盖 到 的 那 部 分 是 这 样 的 。 然 


后 需求 说 明 就 会 成 为 描述 功能 的 活 文档 系统 。 下 一 章 ， 我 将 介绍 如 何 
通过 帝 化 文档 系统 最 有 效 地 使 用 可 执行 需求 说 明 。 


10.4 铭记 


要 频繁 地 验证 可 执行 需求 说 明 ， 以 确保 它们 的 可 靠 性 。 

相 比 用 单元 测试 做 持续 集成 ， 持 续 验 证 的 两 大 难点 是 快速 反馈 和 
稳定 性 。 

请 建立 独立 的 持续 验证 环境 ， 并 使 部 署 完全 自动 化 ， 使 其 更 为 可 


想 办 法 获得 更 快 的 反馈 。 分 开 快速 和 缓慢 的 测试 ， 为 当前 迭代 的 
需求 说 明 创 建 测试 包 ， 把 运行 时 间 较 长 的 可 执行 需求 说 明 集 合 拆 分 成 
更 小 的 集合 。 

不 要 只 是 禁用 失败 的 测试 。 要 么 修复 问题 ， 要 么 把 测试 挪 到 低 优 
先 级 的 回归 测试 包 并 密切 进行 监控 。 


už; q 


我 在 第 3 章 介 绍 了 活 文档 的 概念 ， 并 且 解 释 了 它 的 重要 性 ， 但 还 没 
有 谈 到 构建 它 的 方法 。 在 本 章 ， 我 将 介绍 很 多 团队 实现 活 文 档 系统 的 
做 法 。 

存放 可 执行 需求 说 明文 件 的 目录 并 不 能 称 为 活 文 档 系统 。 想 要 从 
活 文 档 中 受益 ， 我 们 必须 把 需求 说 明 组 织 得 井井有条 ， 不 仅 整 体 上 好 
E, 而且 要 添加 一 些 相关 的 上 下 文 信息 ， 使 我 们 单独 阅读 某 一 部 分 时 
也 很 容易 理解 。 

理想 情况 下 ， 活 文档 系统 必须 有 助 于 我 们 理解 系统 的 行为 ， 也 融 
是 说 它 提供 的 信息 必须 具有 以 下 特点 : 

易于 理解 ; 

前 后 一 致 ; 

井井有条 ， 便 于 使 用 。 


本 章 我 会 介绍 我 调研 的 那些 团队 为 达成 这 些 目标 所 使 用 的 方法 。 


`~ 


11.1 p 


如 第 8 章 所 述 ， 经 过 我 们 严格 精炼 建立 起 来 的 可 执行 需求 说 明 具 有 
专注 性 和 不 言 目 明 的 特点 ， 并 且 使 用 项 目的 领域 语言 进行 描述 。 随 着 
活 文档 系统 的 增长 ， 我 们 不 断 地 为 需求 说 明 增 添 内 容 ， 也 会 将 其 进行 
合并 或 分 解 。 在 系统 的 增长 过 程 中 ， 以 下 建议 有 利于 保持 活 文档 易于 
理解 。 


== s a|= 
1 m =z v 
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文档 随 着 底层 系统 功能 的 增加 而 逐渐 增长 ， 你 会 创建 新 的 需求 说 
明 ， 也 会 对 现 有 的 需求 说 明 进 行 扩 展 。 注 意 不 要 让 需求 说 明 变 得 太 
Fe 

-需求 说 明太 长 往往 标志 着 有 什么 事情 不 对 劲 。 需 求 说 明 越 长 越 
难以 理解 。 

当 需 求 说 明太 长 时 ， 可 能 会 出 现 很 多 问题 。 例 如 : 

所 前 述 概念 的 抽象 级 别 不 恰当 。 此 时 ， 可 以 问 问 你 自己 :“ 我 们 遗 
漏 了 什么 ”， 并 且 试 着 找 出 遗漏 的 、 可 以 帮助 你 分 解 测试 的 概念 。 找 出 
遗漏 的 概念 能 带领 我 们 找到 设计 的 突破 点 。 更 多 内 容 请 参考 7.5.2 节 。 

需求 说 明 描 述 了 多 个 相似 的 功能 ， 而 没有 专注 在 单个 功能 上 。 请 
将 其 拆 分 成 多 个 单独 的 需求 说 明 。 详 见 8.3.13 节 。 

使 用 脚本 去 摘 述 功能 ， 而 没有 使 用 需求 说 明 。 这 时 候 ， 你 可 以 重 
整 相 关内 容 ， 关 注 系 统 “ 要 做 什么 ”而 非 “如 何 做 *"。 更 多 内 容 ， 请 看 
63.21. 

需求 说 明 包含 大 量 不 必要 的 上 下 文 信息 。 可 以 对 其 进行 清理 ， 只 
关注 那些 描述 特定 测试 的 目标 的 重要 特性 。 


多 小 的 需求 说 明 来 描述 单个 功 外 


随 着 系统 的 演进 ， 我 们 对 领域 的 理解 也 会 发 生变 化 。 原 先 不 同 的 
概念 到 后 来 可 能 变 得 很 类 似 一 一 我 们 发 现 这 是 事物 的 两 面 性 。 类 似 
地 ， 我 们 可 能 会 将 复杂 的 概念 分 解 成 几 个 较 小 的 概念 ， 忽 然 之 间 却 发 
现 某 个 较 小 的 概念 与 现 有 的 某 个 概念 很 类 似 。 在 这 些 情况 下 ， 我 们 应 
该 将 活 文档 系统 中 摘 述 同一 功能 的 多 个 需求 说 明 进 行 合 并 。 

在 天 空 网 络 服务 部 门 ，Rakesh Patel 的 团队 在 拆 分 需求 说 明 时 就 一 
度 做 得 有 些 过 头 了 。 单 个 需求 说 明 不 再 描述 一 个 完整 的 功能 。Patel 
说 : 

“如 果 一 个 文件 里 含有 大 量 的 例子 ， 该 文件 就 会 更 加 难以 使 用 ， 因 
为 大 量 类 似 的 代码 可 能 会 混淆 视听 。 以 前 我 喜欢 将 不 同 的 例子 放 在 不 
同 的 文件 中 ， 但 是 后 来 我 发 现 文 件 多 了 也 会 变 得 难以 追踪 。” 

-如果 我 们 必须 看 10 份 需求 说 明 才 能 理解 一 个 功能 ， 那 么 是 时 候 
考虑 重新 整理 文档 了 。 


11.1.3 Zs fi 


在 为 系统 增加 功能 的 过 程 中 ， 有 时 我 们 会 发 现 有 些 类 似 的 需求 说 
明之 间 只 有 细微 的 差别 。 

-此 时 我 们 应 该 后 退 一 步 ， 从 更 高 的 抽象 层次 仔细 去 查看 需求 说 
明 所 描述 的 内 容 。 

一 旦 我 们 找 出 更 高 层次 的 概念 ， 一 套 完整 的 需求 说 明 通 常 可 以 蔡 
换 成 只 关注 其 不 同 之 处 的 单个 需求 说 明 。 这 可 以 让 信息 更 容易 理解 、 
a i se 

类 似 于 7.5.2 节 所 描述 的 过 程 。 


适用 于 : 项 目 干系 人 不 是 技术 人 员 时 

有 些 团队 并 不 是 拿 可 执行 的 需求 说 明 来 创建 一 种 沟通 工具 ， 而 是 
专注 于 利用 它们 去 做 功能 回归 测试 以 及 编写 技术 上 的 验收 测试 。 这 样 
一 来 ， 开 发 人 员 编 写 测试 更 快 了 ， 但 也 使 得 测试 人 员 阅 读 测 试 更 加 困 


难 ， 对 非 开 发 人 员 来 说 更 是 无 法 理解 的 。Johannes Link 在 他 使 用 FIT 
的 第 一 个 项 目 里 有 过 这 样 的 经 历 : 

“最 终 我 们 的 测试 有 了 大 量 的 重复 。 开 发 人 员 能 够 理解 测试 ， 但 是 
对 业务 人 员 来 说 这 些 测试 就 显得 十 分 隆 汲 了 。 相 比 JUnit 测 试 ， 维 护 与 
运行 这 些 测试 的 时 间 成 本 更 高 了 。 最 后 我 们 抛弃 了 这 些 测试 中 的 一 部 
分 ， 并 用 JUnit 进 行 了 重 写 。” 


注释 : 中 第 一 个 专用 于 可 执行 需求 说 明 的 自动 化 工具 。 


> 如 果 我 们 想 把 需求 说 明 当 成 一 种 沟通 工具 ， 那 么 以 技术 语言 
描述 需求 说 明 ， 是 一 种 比较 低 效 的 做 法 。 如 果 商 业 用 户 关心 可 执行 需 
求 说 明 ， 那 么 需求 说 明 就 应 该 用 他 们 能 理解 的 语言 来 描述 。 如 果 商 业 
用 户 并 不 关心 ， 那 么 我 们 就 应 该 使 用 技术 化 的 测试 工具 来 获得 需求 说 
明 。 

当 活 文档 系统 包含 技术 上 的 自动 化 概念 时 ， 比 如 为 了 确保 某 个 处 
理 过 程 的 结束 而 等 待 特定 时 间 的 命令 ， 就 表明 团队 需要 重新 审视 底层 
系统 的 设计 了 。 在 活 文 档 中 需要 使 用 技术 化 的 概念 ， 往 往 意味 着 系统 
设计 出 了 问题 ， 比 如 异步 进程 的 可 靠 性 出 了 问题 〈 详 见 本 章 末尾 的 
11.4 节 ) 。 

可 以 使 用 技术 语言 的 唯一 情况 是 利益 相关 者 也 是 技术 人 员 ， 而 且 
他 们 能 以 技术 语言 (比如 SQL 查询 、DOM 的 标识 符 等 ) 理 解 在 做 什么 事 
情 时 。 请 注意 ， 即 使 利益 相关 者 是 技术 人 员 ， 我 们 在 使 用 此 类 技术 语 
言 时 往往 还 是 会 描述 “如 何 测 试 某 个 功能 "”， 而 不 是 系统 “具有 什么 功 
能 ”。 虽 然 编 写 此 类 测试 可 能 一 开始 比较 快 ， 但 是 长 远 来 看 它们 会 导 至 
维护 问题 。 更 多 内 容 请 参见 8.3.2 节 。 

为 了 与 能 理解 脚本 的 利益 相关 者 一 起 描述 项 目的 验收 测试 ，Mike 
Vogel 使 用 了 DbFit， 这 是 我 编写 的 一 个 FitrNesse 扩 展 ， 用 于 编写 数据 库 
测试 脚本 。 事 后 看 来 ， 他 认为 这 是 个 错误 : 

“一 开始 他 们 很 高 兴 ， 因 为 他 们 可 以 快速 地 使 用 DbFit 而 无 需 编写 
定制 的 fixture， 这 样 ， 他 们 从 第 一 天 开始 就 拥有 了 自动 化 测试 。 后 


来 ， 随 着 项 目 复杂 度 的 增加 ， 发 布 计划 时 间 趋 紧 ， 想 要 回去 重新 创建 
测试 fixture， 让 系统 更 易 测试 并 且 让 测试 更 为 简单 、 更 易 理解 ， 已 经 
是 可 望 而 不 可 及 的 事情 了 。 最 终 这 种 做 法 让 我 们 的 测试 很 脆弱 很 复 


ARNO 
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活 文档 可 能 是 项 目 里 最 “长 寿 ” 的 工件 了 。 技 术 会 推陈出新 ， 代 码 
会 新 旧 更 替 ， 而 活 文档 系统 描述 的 是 业务 如 何 运 作 。 我 们 会 在 几 个 月 
或 者 几 年 内 不 断 为 其 增加 内 容 ， 并 且 需 要 让 它 在 以 后 查阅 时 能 让 人 理 
解 。 对 许多 团队 来 说 ， 其 中 最 大 的 一 个 挑战 是 让 活 文档 的 结构 和 语言 
保持 一 致 。 Stuart Taylor 对 此 进行 了 巧妙 的 解释 : 

“如 果 你 编写 的 BDD 测 试 (可 执行 需求 说 明 ) 非常 清晰 ， 比 方 说 
由 于 每 次 使 用 的 方式 不 同 ， 跳 转 到 一 个 页 面 会 有 57 种 方法 ， 而 你 的 测 
试 详细 描述 了 这 些 方法 ， 那 么 这 其 实 是 一 个 危险 信号 。 不 断 地 重 构 描 
述 语言 ， 使 其 既 不 要 抽象 到 难处 理 的 程度 ， 又 不 要 详尽 到 不 像 是 BDD 
测试 ， 这 点 是 很 重要 的 。” 

前 后 一 致 的 语言 也 可 以 让 可 执行 需求 说 明 的 自动 化 过 程 更 加 高 
效 。 对 Gaspar Nagy 来 说 ， 这 是 开发 中 的 一 个 关键 原则 : 

“对 验收 标准 来 说 ， 使 用 一 致 的 措辞 与 一 致 的 表达 语言 很 重要 。 这 
样 开发 人 员 更 容易 确定 它 是 否 与 现 有 的 结构 一 样 ， 并 且 更 容易 自动 
化 。 ý 

想 要 保持 活 文 档 的 一 致 性 ， 我 们 必须 不 断 地 对 其 进行 完善 ， 使 其 
与 当前 软件 系统 应 用 的 模型 保持 同步 。 随 着 软件 概念 的 不 断 演进 ， 活 
文档 系统 中 也 需要 相应 地 体现 出 来 。 这 些 维 护 需要 成 本 ， 但 若非 如 
此 ， 也 就 不 存在 活 的 文档 了 。 


11.2.1 5 一 种 语言 


几乎 所 有 团队 最 终 都 总 化 出 了 一 种 需求 说 明 的 语言 ， 一 组 需求 说 
明 可 重用 的 模式 。 对 于 有 某 举 团队 ， 这 种 语言 演化 了 几 个 月 ， 并 且 往 往 


背负 着 维护 性 问题 的 “罪名 ”。 

Andrew Jackman 说 BNP Paribas 公 司 的 Sierra 团 队 是 在 发 现 目 动 化 层 
增长 过 快 的 情况 下 开始 演化 这 种 语言 的 : 

“我 们 现在 有 非常 多 的 fixture 人 代码， 逐渐 出 现 了 维护 性 问题 。 我 们 
有 大 量 非常 特定 的 fixture， 它 们 元 长 的 描述 只 在 一 个 测试 里 用 到 ， 我 
们 试图 将 其 浓缩 成 一 种 通用 语言 。 我 们 在 FIT 里 开发 了 一 种 给 web 测 试 
使 用 的 迷你 型 领域 特定 语言 。 这 样 就 减少 了 大 量 的 fixture 代 码 。>” 

有 些 团队 很 快 就 演化 出 了 这 种 语言 的 基础 。Rob Park 所 在 的 属于 
一 家 美国 大 型 保险 机 构 的 团队 就 是 一 个 很 好 的 例子 : 

“语言 演化 得 很 快 。 最 初 的 三 四 个 fixture [自动 化 的 测试 ] 类 都 是 
相互 独立 的 。 我 们 试 着 让 它 运 行 起 来 并 且 专 注 在 对 话 描述 部 分 。 我 们 
立刻 注意 到 step 文 件 《自动 化 测试 的 类 ) 里 有 些 重复 ， 然 后 我 们 开始 
将 重复 部 分 从 中 剥离 。 每 个 用 户 故 事 都 有 一 个 Gherkin 了 文件 (可 执 
行 需求 说 明 ) ， 但 是 我 们 描述 同一 个 功能 的 故事 卡 有 五 六 张 。 

这 些 用 户 故事 的 step 都 非常 相像 ， 所 以 我 们 发 现 即 使 描述 一 个 业 
务 功能 的 用 户 故事 有 好 几 个 ， 使 用 单个 step 文 件 的 实际 效果 也 会 更 好 
些 。 否 则 ， 即 使 故事 的 描述 只 有 一 行 ， 也 会 出 现 大 量 的 重复 。>” 


注释 : ()Gherkin 是 Cucumber 和 SpecFlow 里 用 于 描述 功能 的 语法 。 
一 一 译 者 注 

-演化 出 一 种 语言 有 助 于 降低 自动 化 层 的 维护 成 本 ， 因 为 重用 现 
有 的 短语 描述 新 的 需求 说 明 ， 可 以 促成 需求 说 明 的 一 致 性 。 

只 要 活 文 档 系 统 是 自动 化 的 ， 并 且 直 接 与 软件 相连 接 ， 那 么 它 就 
可 以 确保 软件 模型 与 业务 模型 相 一 致 。 因 此 ， 为 活 文档 系统 六 化 出 一 
种 语言 是 创建 并 维护 统一 语言 (如 第 8 章 所 述 ) 的 一 种 绝 佳 方式 。 

11.2.2 求 说 明 语 言 

适用 于 : Web 项 目 


有 些 团队 通过 虚构 人 物 来 描述 用 户 故 事 ， 特 别 是 在 开发 网 站 的 时 
候 。 在 这 些 情况 下 ， 需 求 说 明 语 言 可 以 从 不 同人 物 能 够 执行 的 操作 上 
来 提取 。 

> 虚构 人 物 有 助 于 简化 可 执行 需求 说 明 并 且 可 以 使 其 更 加 容易 维 
护 。 

爱 答 华 州 助 学 贷 款 公司 的 团队 将 其 需求 说 明 里 使 用 的 语言 进行 了 
拟人 化 。Tim Andersen 说 : 

“我 们 并 不 会 模糊 地 使 用 用 户 的 概念 ， 我 们 使 用 的 是 不 同 的 人 物 ， 
并 考虑 他 们 使 用 系统 的 动机 、 方 式 及 其 目的 。 我 们 还 为 不 同 的 角色 取 
了 名 字 。Boris 是 借款 人 ，Carrie 是 共同 签署 人 。 

虚构 人 物 很 有 帮助 ， 因 为 它们 可 以 让 我 们 从 一 个 使 用 者 的 角度 来 
考虑 系统 的 行为 。 并 且 它 们 还 有 很 多 我 们 事先 没有 预料 到 的 其 他 作 
用 。 例 如 ， 因 为 虚构 人 物 是 测试 助手 〈 自 动 化 组 件 ) ， 它 可 以 从 一 个 
更 舍 适 的 切入 点 与 系统 进行 交互 。” 

对 于 用 户 交 互 不 多 的 项 目 来 说 ， 使 用 虚构 人 物 并 没有 太 大 的 意 
义 。 因 为 在 之 前 的 项 目 里 使 用 虚构 人 物 取 得 了 成 功 ，Andersen 曾 尝试 
将 相同 的 概念 应 用 到 一 个 技术 性 的 数据 处 理 系统 中 。 他 最 终 放弃 了 这 
一 做 法 ， 并 改 用 了 过 程 流 模型 。 

“多 个 不 同 来 源 的 数据 载 入 到 电话 系统 ， 这 样 人 们 才 可 以 打 电 话 。 
电话 数据 更 新 后 ， 我 们 会 将 其 发 回 给 数据 提供 方 。 这 是 一 个 批 处 理 过 
程 。 事 实 上 没有 真正 的 使 用 者 ， 它 只 是 自己 在 运行 而 已 。 虚 构 人 物 并 
不 适 舍 。 我 们 尝试 使 用 虚构 人 物 来 定义 测试 ， 却 没有 得 到 业务 人 员 的 
认同 。 所 以 我 删除 了 所 有 虚构 人 物 的 代码 ， 并 且 改 成 了 基于 使 用 
Given-When-Then 关 键 字 的 过 程 。 这 样 一 来 清爽 多 了 ， 对 每 个 人 来 说 
也 更 容易 接受 。” 

围绕 着 虚构 人 物 的 行为 来 演化 统一 语言 ， 可 以 确保 我 们 对 每 个 人 
物 在 系统 中 有 哪些 需求 的 理解 ， 与 他 们 实际 如 何 使 用 系统 的 行为 是 相 
一 致 的 。 这 可 以 推进 需求 说 明 所 使 用 的 语言 与 结构 ， 并 可 以 帮助 我 们 
打造 前 后 一 致 的 文档 系统 。 


CE 
用 户 :Jane 


| 
Vo” 


11.2.3 语言 


适用 于 : 不 进行 需求 说 明 工 作坊 时 

> 如果 你 决定 不 进行 大 型 工作 坊 而 使 用 其 他 蔡 代 方法 ， 那 么 请 协 
作 定 义 统一 语言 。 

Christian Hassa 说 协作 定义 统一 语言 是 他 们 团队 面临 的 一 个 最 大 挑 
战 : 

“要 构建 一 种 统一 的 、 可 以 良好 绑 定 的 领域 语言 ， 如 果 没 有 任何 指 
导 是 完全 不 可 能 做 到 的 。 对 测试 人 员 编 写 的 内 容 ， 开 发 人 员 不 得 不 重 
新 进行 梳理 。 有 时 候 这 是 因为 测试 人 员 记 录 东 西 所 采用 的 方式 不 够 明 
朗 或 者 不 容易 绑 定 (自动 化 ) 。 测 试 人 员 编 写 了 多 少 内 容 ， 我 们 就 得 
重新 梳理 多 少 内 容 。 如 果 我 们 在 他 们 编写 第 一 个 例子 的 时 候 就 立刻 进 
ITRE (EI) ， 那 么 我 们 就 能 及 时 发 现 问题 。 

这 就 像 结 对 编程 与 事后 的 代码 评审 相 比 较 。 在 结对 编程 的 时 候 ， 
如 果 对 方 觉得 你 做 的 不 对 ， 他 会 立刻 告诉 你 ， 这 样 可 以 及 时 改正 。 而 
对 于 代码 评审 ， 如 果 你 发 现 了 问题 ， 你 可 能 会 说 : 好 的 ， 下 次 我 会 换 
一 种 做 法 ， 这 次 就 先 这 样 吧 。>” 


Christian Hassa 建 议 ， 与 其 在 发 现 不 一 致 性 问题 后 回头 去 修正 ， 不 
如 让 开发 人 员 与 测试 人 员 结对 编写 需求 说 明 ， 这 样 可 以 预防 此 类 问题 
的 出 现 。 这 就 好 比 飞 机 的 驾驶 员 与 副 驾 驶 一 起 进行 协作 ， 以 便 预 防 问 
题 的 出 现 。 这 可 以 极度 降低 需求 说 明 质 量 低下 的 风险 ， 因 为 在 编写 过 
程 中 另外 一 个 人 验证 了 需求 说 明 ， 并 且 提 防 着 问题 出 现 。 

BNP Paribas 公 司 的 Sierra 团 队 有 一 种 比较 稳定 的 语言 ， 这 种 语言 演 
化 了 很 多 年 ， 他 们 的 业务 分 析 师 可 以 独自 使 用 这 种 语言 编写 新 的 需求 
说 明 。 为 了 避免 语言 不 一 致 或 者 需求 说 明 难 以 自动 化 ， 他 们 会 要 求 开 
发 人 员 评 审 那些 与 现 有 需求 说 明 在 结构 上 差别 很 大 的 需求 说 明 。Bekk 
咨询 公司 团队 在 挪威 奶牛 记录 系统 项 目 中 使 用 了 类 似 的 过 程 。 他 们 的 
业务 人 员 会 编写 带 例子 的 需求 说 明 ， 而 开发 人 员 会 对 此 进行 评审 ， 并 
且 提 供 建 议 使 其 与 活 文档 系统 的 其 余部 分 更 加 一 致 。 


~ 将 需求 说 明 的 构建 模块 文档 化 是 一 种 很 好 的 做 法 。 这 有 助 于 我 
们 重用 组 件 并 维持 语言 的 一 致 性 。 

有 些 团队 为 构建 模块 划分 出 单独 的 文档 区 域 。 在 爱 荷 华 州 助 学 贷 
球 公 司 ， 他 们 有 一 个 页 面包 含 了 所 有 的 虚构 人 物 。 其 中 没有 任何 断 
言 ， 但 是 它 却 展现 了 哪些 构建 模块 已 经 存在 。 这 个 页 面 是 由 底层 的 自 
动 化 代码 生成 的 ， 它 为 活 文档 创建 了 活字 上 典 。 

为 项 目 语言 构建 优秀 的 文档 还 有 一 种 更 为 简单 的 方式 。 在 为 编写 
本 书 进行 调研 的 过 程 中 ， 当 参与 者 被 问 到 对 于 团队 的 新 成 员 ， 他 们 会 
给 予 什么 样 的 建议 ， 以 便 编 写 出 恨 好 的 需求 说 明 时 ， 几 乎 所 有 人 都 建 
议 去 参考 现 有 的 需求 说 明 。 为 了 将 需求 说 明 的 构建 模块 文档 化 ， 从 现 
有 的 需求 说 明 中 选 出 一 些 好 的 、 具 有 代表 性 的 例子 ， 不 失 为 一 种 好 的 
做 法 。 因 为 这 些 需求 说 明 已 经 是 可 执行 的 了 ， 所 以 为 构建 模块 编写 的 
文档 ， 其 精确 性 与 一 致 性 是 有 你 证 的 。 

因为 在 团队 构建 项 目的 长 期 过 程 中 ， 活 文档 始终 为 团队 提供 支 
持 ， 所 以 可 能 存在 一 些 文档 还 在 使 用 过 时 术语 的 风险 。 有 人 可 能 会 使 
用 团队 三 年 前 开始 使 用 的 术语 ， 而 有 的 则 可 能 会 使 用 两 年 前 才 开 始 使 


用 的 术语 ， 等 等 ， 这 取决 于 需求 说 明 最 初 是 什么 时 候 编写 的 。 这 几乎 
完全 违背 了 活 文档 系统 的 观点 ， 因 为 我 们 需要 将 老 的 术语 翻译 成 新 的 
术语 。 

在 语言 壮 化 的 过 程 中 ， 维 持 整 个 文档 系统 的 一 致 性 并 不 需要 耗费 
多 少 精 力 。 而 且 一 致 的 文档 将 会 给 团队 市 来 更 多 的 长 期 价值 。 


11.3 必须 组 织 得 [a 


活 文 档 系统 增长 迅速 。 随 着 项 目的 推进 ， 开 发 团队 会 频繁 地 加 入 
新 的 需求 说 明 。 需 求 说 明 在 项 目 进行 几 个 月 后 达到 数 百 个 是 很 常见 
的 。 我 采访 过 几 个 团队 ， 他 们 在 几 年 时 间 里 对 活 文档 系统 的 签 入 次 数 
超过 了 5 万 次 。 

要 让 活 文档 发 挥 作用 ， 用 户 必 须 可 以 很 容易 地 找 出 所 需 功 能 的 描 
述 ， 这 意味 着 整个 文档 系统 必须 组 织 有 序 ， 并 且 单 个 需求 说 明 必 须 便 
于 访问 。 

Phil cowans 说 ， 他 对 于 活 文 档 最 大 的 经 验 是 团队 应 该 尽早 考虑 高 
层次 的 组 织 结构 : 

“我 们 没有 考虑 测试 的 高 层次 组 织 结 构 ， 只 是 不 停 地 添加 新 的 测 
试 ， 结 果 就 是 很 难 找 出 哪些 测试 涉及 了 哪个 功能 。 收 集 有 关 网 站 功能 


系列 的 描述 并 据 此 (而 不 仅仅 是 单个 功能 ) 组 织 测试 会 有 所 帮助 。 我 
认为 这 样 有 助 于 开发 出 比较 容易 理解 的 产品 和 易于 维护 的 代码 库 。” 
如 果 每 次 我 们 想 要 理解 某 个 功能 如 何 运 作 ， 束 不 得 不 耗费 数 小 时 
从 貌似 无 关 的 数 百 个 文件 里 拼凑 出 全 局 ， 那 么 很 可 能 我 们 还 会 去 阅读 
程序 代码 。 为 了 尽 可 能 发 挥 活 文档 的 优势 ， 信 息 必须 很 容易 查找 到 。 
以 下 是 一 些 相 关 的 技巧 。 
11.3.1 组 织 当 前 的 工 


很 多 可 执行 需求 说 明 的 自动 化 工具 允许 我 们 将 需求 说 明 按 层次 结 
构 归 类 ， 要 么 是 以 网 站 节 氮 与 子 节 扣 的 形式 ， 要 么 是 以 文件 目录 与 子 
目录 的 形式 。 

~ 如 果 你 使 用 可 执行 需求 说 明 的 自动 化 工具 ， 那 么 将 目前 正在 进 
行 的 工作 归 类 在 一 起 通常 是 一 种 很 好 的 做 法 。 

正如 10.2.6 节 所 建议 的 ， 按 层次 结构 归 类 需求 说 明 ， 我 们 就 可 以 将 
此 类 需求 说 明 以 测试 包 的 形式 快速 执行 。 

通 弟 一 个 用 尸 故 事 需要 我 们 更 改 多 处 功能 区 。 例 如 ， 一 个 天 于 改 
进 注册 功能 的 用 户 故 事 ， 它 可 能 影响 后 端的 用 户 报表 以 及 系统 验证 年 
龄 的 行为 。 也 可 能 需要 实现 与 PayPal 和 Gmail 的 新 的 集 1 成 。 所 有 这 些 
功能 都 应 该 由 独立 的 并 且 专 门 的 需求 说 明 来 描述 。 同 时 对 于 每 个 用 户 
故事 的 时 间 完 成 标准 还 要 有 清晰 的 定义 。 与 一 个 用 户 故 事 相 关 的 所 有 
内 容 都 应 该 归 类 在 一 起 ， 以 便 容易 地 执行 所 有 这 些 测试 。 

请 看 图 11-1 所 建议 的 组 织 方式 :“ 当 前 迭代 ”的 分 支 。 


11.3.2 组 织 


用 户 故事 作为 计划 的 工具 是 非常 出 色 的 ， 但 是 它 在 组 织 现 有 系统 
功能 方面 并 没有 太 大 用 处 。 如 图 11-1 所 示 的 编号 为 128 的 用 户 故事 ， 其 
中 有 一 部 分 是 PayPal 集 成 ， 当 做 完 这 个 用 户 故 事 半 年 后 再 回头 来 看 ， 
编号 128 的 用 户 故 事 与 PayPal 集 成 就 显得 风 马 牛 不 相 及 了 〔 除 非 要 追踪 
它 的 来 龙 去 脉 ) 。 如 果 有 谁 想 要 知道 PayPal 的 集成 原理 ， 他 需要 知道 
具体 的 用 户 故 事 编 号 才能 找到 。 


-很 多 团队 在 完成 可 执行 需求 说 明 后 ， 会 按 功 能 区 域 对 其 进行 重 
新 组 织 ， 使 其 具有 层次 结构 。 这 样 浏览 基于 业务 功能 的 层次 结构 就 可 
以 很 容易 地 找到 一 个 功能 的 详细 解释 。 

图 11-1 中 ,“ 功 能 集 ” 下 的 分 支 展 示 了 这 一 点 。 一 旦 编号 128 的 用 户 
故事 完成 后 ， 我 们 应 该 将 PayPal 集 成 的 需求 说 明 转 移 到 “付款 ”分 支 之 
下 ， 将 “后 端 用 户 报 表 ”* 改 成 “用 户 管 理 *， 等 等 。 以 这 种 方式 组 织 活 文 
档 系 统 后 ， 如 果 需 要 讨论 MasterCard 付 款 功 能 的 需求 变更 ， 我 们 就 可 
以 很 快 找到 与 此 相关 的 所 有 例子 。 


3D 安 全 性 
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| 已 知 的 回归 问题 远程 电 子 邮件 


图 11-1 以 功能 区 域 (比如 付款 和 用 户 管理 ) 组 织 的 活 文 档 层次 结构 。 
当前 迭代 的 需求 说 明 是 以 用 户 故事 和 功能 来 组 织 的 。 一 些 还 需 等 待 更 
多 信息 的 已 知 问题 ， 也 可 以 单独 放 在 一 个 分 支 里 


如 果 还 想 要 知道 某 个 功能 具体 是 由 哪个 用 户 故 事 引 入 的 ， 还 有 一 
些 工具 可 以 让 你 以 不 同 的 层次 结构 来 交叉 引用 同一 个 需求 说 明 。 


11.3.3 组 织 


适用 于 : 用 户 界 面 的 文档 系统 

-在 活 文档 系统 中 复制 用 户 界面 的 导航 结构 。 

Beazley 公 司 Ian Cooper 的 团队 在 他 们 的 活 文档 系统 里 应 用 了 一 种 
创新 的 组 织 方式 。 他 们 没有 按照 功能 区 域 来 组 织 ， 而 是 在 活 文档 系统 
里 复制 了 用 户 界 面 导 航 结构 。Cooper 说 : 

“FitNesse 测 试 让 我 们 可 以 找 出 用 户 故 事 的 相关 内 容 。 但 是 使 用 这 
种 方式 来 浏览 却 异常 艰难 。 怎 样 才能 找到 代表 软件 某 一 部 分 功能 的 用 
户 故 事 呢 ? 

我 们 对 此 进行 了 重组 ， 这 样 FitNesse 页 面 看 起 来 像 是 一 份 帮助 页 
面 。 当 我 打开 某 个 页 面 时 ， 有 FitNesse 测 试 可 以 告诉 我 本 页 面具 有 了 哪 
些 功能 。 如 果 我 点 击 对 话 框 旁边 的 某 个 链接 ， 它 会 跳 转 到 另外 一 个 页 
面 ， 那 个 页 面 对 该 对 话 框 有 详细 解释 。 这 样 如 果 想 要 了 解 什么 功能 ， 
很 容易 就 知道 在 哪里 可 以 获得 这 类 信息 。” 

对 于 那些 清晰 地 定义 了 导航 路 径 的 系统 来 说 ， 这 种 方式 很 直观 ， 
比如 办 公 系 统 。 但 是 如 果 用 户 界 面 导 航路 径 会 经 常 变换， 那么 这 可 能 
会 导致 很 多 维护 性 问题 。 

11.3.4 按 业 务 ; 组 织 


适用 于 : 端 到 端的 用 例 需 具 备 可 追溯 性 时 

-按照 业务 流程 来 组 织 活 文档 系统 ， 在 端 到 端的 用 例 里 可 以 很 容 
易 地 追溯 系统 的 功能 。 

Mike Vogel 参 与 了 一 个 为 药物 研究 提供 支持 的 软件 系统 ， 他 的 团 
队 按照 业务 流程 来 组 织 他 们 的 活 文档 系统 。 他 是 这 么 解释 这 个 方法 
BY: 

“我 们 按照 用 例 来 组 织 (FitNesse) 测 试 。 我 们 的 用 例 是 按 层次 结构 
组 织 的 ， 顶 层 的 用 例 代 表 系 统 的 目标 。 每 一 个 顶层 用 例 也 是 对 端 到 端 
业务 流程 目标 的 定义 。 如 果 一 个 用 例会 引用 一 些 较 低 层级 的 用 例 ， 那 
么 它 就 是 子 流程 。 

需求 文档 的 目录 与 我 们 的 测试 目录 是 一 样 的 。 这 让 我 们 可 以 更 容 
易 地 理解 测试 如 何 与 业务 流程 相 一 致 。 同 时 它 还 建立 了 从 业务 需求 到 


测试 的 直接 可 溯 性 ， 这 很 关键 ， 这 样 才能 满足 我 们 领域 里 的 管理 需 
求 。 ” 

这 些 并 不 是 组 织 活 文档 仅 有 的 方式 。 另 外 一 个 很 好 的 方法 是 按照 
帮助 系统 或 者 用 户 指南 的 章节 来 组 织 信息 。 请 将 这 些 想 法 当 作 灵感 ， 
触发 你 为 自己 的 文档 系统 找到 建立 层次 结构 的 最 佳 方式 。 


11.3.5 引用 可 执行 需求 说 明 时 请 使 用 标签 而 


适用 于 : ee 

如 今 ， 许 多 活 文档 工具 都 支持 标签 
性 ， 可 以 附加 到 任何 页 面 或 文件 上 。 StF EDEN, 相对 于 使 用 
用 户 故 事 或 用 例 来 保持 需求 说 明 的 层次 结构 ， 使 用 这 类 元 数据 通常 效 
果 更 好 。 当 领域 模型 变更 时 ， 活 文档 应 该 也 要 作出 相应 的 变更 。 需 求 
说 明 往 往 会 迁移 、 合 并 、 分 解 或 者 变更 。 想 依赖 于 严格 的 静态 层次 结 
构 来 获得 可 追溯 性 是 不 可 能 的 。 但 是 ， 如 果 我 们 将 故事 或 用 例 的 编号 
当 作 标签 附 到 需求 说 明 上 ， 就 很 容易 实现 可 仍 淹 性。 

如 果 你 想 要 在 其 他 工具 中 〈 例 如 缺陷 追踪 系统 或 进度 计划 工具 ) 
引用 活 文档 页 面 ， 那 么 标签 也 会 非常 有 用 。 如 果 我 们 在 引用 可 执行 的 
需求 说 明 时 使 用 基于 页 面 当前 所 在 位 置 的 URL， 那 么 该 需求 说 明 以 后 
将 无 法 随意 挪动 ， 否 则 URL 链 接 将 会 失效 。 

-> 附 上 标签 ， 并 且 链 接 到 相应 的 搜索 结果 ， 可 以 让 系统 更 具 弹 
性 ， 方 便 将 来 进行 改动 。 

即使 你 用 的 工具 不 是 基于 Web 的 ， 而 是 将 需求 说 明 放 在 项 目的 目 
录 里 ， 只 要 有 一 个 简单 的 脚本 ， 你 还 是 可 以 使 用 标签 。Bekk 咨 询 公 司 
的 挪威 奶牛 记录 系统 团队 就 是 这 么 做 的 。Berge Lotre 解 释 道 : 

“我 们 使 用 Confluence 与 客户 共享 Cucumber 测 试 ， 并 且 直接 将 
Cucumber 测 试 从 Subversion 里 链接 到 Confluence。 这 样 我 们 重新 组 织 
Cucumber 测 试 的 文件 结构 就 会 有 有 麻烦， 但 是 使 用 标签 可 以 帮助 我 们 
克服 这 个 缺点 。 现 在 ， 我 们 使 用 标签 来 记录 哪些 Cucumber 测 试 覆盖 
了 哪些 需求 。” 


不 要 直接 引用 活 文档 系统 中 某 个 具体 的 需求 说 明 ， 因 为 这 会 妨碍 
我 们 以 后 对 文档 进行 重组 。 将 可 以 动态 搜索 的 元 数据 、 标 签 或 者 关键 
词 作为 外 部 链接 要 好 得 多 。 

活 文 档 系 统 不 仪 仅 是 一 堆 可 执行 的 需求 说 明 。 深 埋 在 杂乱 不 堪 的 
测试 里 作为 文档 的 信息 是 毫 无 用 处 的 。 为 了 获得 实例 化 需求 说 明 的 长 
远 利益 ， 我 们 必须 确保 文档 的 组 织 方 式 有 利于 大 家 快速 地 找到 某 个 功 
能 的 需求 说 明 ， 并 测试 该 功能 。 

我 在 这 里 介绍 了 需求 说 明 最 常见 的 组 织 方式 ， 但 是 你 可 以 继续 挖 
扬 。 找 出 适合 你 自己 的 方式 来 组 织 文 档 ， 能 够 方便 商业 用 户 、 测 试 人 
员 以 及 开发 人 员 直 观 地 找到 他 们 想 要 的 内 容 。 


11.4 Rea 


最 初 ， 许 多 团队 不 明白 活 文档 实时 反映 了 它 所 描述 系统 的 领域 模 
型 。 如 果 系 统 的 设计 是 由 可 执行 需求 说 明 驱 动 的 ， 那 么 需求 说 明 与 软 
件 将 会 用 到 相同 的 统一 语言 和 领域 模型 。 

在 可 执行 需求 说 明 里 发 现 偶然 的 复杂 性 ， 意 味 着 你 应 该 去 简化 系 
统 并 使 其 易于 维护 和 使 用 。Channing Walton 将 这 种 方法 称 为 “聆听 测 
试 "?。 他 在 UBS 开 发 订单 管理 系统 ， 其 工作 流 的 验收 条 件 非常 复杂 。 他 
th: 

“如 果 测 试 太 复杂 ， 就 说 明 系 统 有 些 问题 。 工 作 流 的 测试 非常 痛 
苦 。 有 很 多 事情 要 做 ， 并 且 测 试 非常 复杂 。 开 发 人 员 开 始 质 疑 为 何 测 
试 如 此 复杂 。 结 果 发 现 由 于 每 个 部 门 并 不 知道 其 他 部 门 的 工作 内 容 ， 
导致 工作 流 太 过 复杂 化 。 测 试 有 助 于 大 家 看 到 其 他 部 门 也 在 做 验证 并 
处 理 错 误 ， 因 为 它 将 所 有 和 内容 放 在 了 一 起 。 调 整 之 后 ， 整 件 事情 简单 
ZT.” 

自动 化 可 执行 需求 说 明 强 迫 开发 人 员 使 用 自己 开发 的 系统 ， 体 验 
其 使 用 感受 ， 因 为 他 们 必须 使 用 为 客户 设计 的 界面 。 如 果 可 执行 需求 
说 明 难 以 自动 化 ， 那 就 代表 客户 端 API 很 难 使 用 ， 也 就 意味 着 是 时 候 
简化 API 了 。 这 就 是 Pascal Mestdach 获 得 的 一 个 最 重要 的 经 验 教训 |: 


“你 编写 测试 的 方式 就 确定 了 你 如 何 设计 并 编写 代码 。 如 果 你 需要 
在 一 部 分 测试 中 持久 化 病人 的 数据 ， 你 就 需要 构造 一 个 数据 集 ， 将 4 个 
表格 的 数据 填 入 数据 集 ， 然 后 调用 一 个 大 型 方法 进行 持久 化 ， 并 且 调 
用 该 类 的 一 些 配置 方法 。 这 让 真正 的 场景 测试 难以 进行 。 如 果 配 置 很 
难 ， 那 么 测试 也 会 很 难 ， 那 么 在 真实 代码 中 持久 化 病人 的 数据 也 将 变 
得 比较 困难 。>” 

Markus Girtner 指 出 ， 宛 长 的 配置 标志 着 糟糕 的 APIT 设 计 : 

“ 当 你 注意 到 一 串 元 长 的 配置 时 ， 请 为 你 的 API 用 户 以 及 你 所 构造 
的 东西 着 想 一 下 。 处 理 你 复杂 的 API 将 让 某 人 痛苦 不 堪 。 你 真 的 打算 
这 么 做 吗 ? ” 

Ra a a 
代码 的 微小 改动 经 常 导致 很 多 活 文 档 系统 的 测试 失败 ， 这 就 是 “ 堵 弹 式 
修改 ”的 一 个 例子 。 这 促使 他 去 研究 如 何 改善 系统 的 设计 : 

“这 意味 着 架构 有 问题 。 起 初 你 纠结 于 此 ， 而 后 你 开始 意识 到 问题 
并 不 在 FitNesse 身 上 ， 而 是 它 与 系统 交互 的 方式 有 问题 。” 

Cooper 建 议 将 活 文档 看 作 是 系统 的 另 一 个 用 户 界 面 。 如 果 这 个 界 
面 难以 编写 和 维护 ， 那 么 真实 的 用 户 界面 也 将 遭遇 同样 的 问题 。 

在 活 文档 里 ， 如 果 有 一 个 概念 是 通过 复杂 的 交互 来 定义 的 ， 
很 可 能 意味 着 程序 代码 里 也 存在 同样 复杂 的 交互 。 如 果 活 文档 里 描述 
ee ee a 
F E 有 反之， 可 以 将 其 当 作 一 个 警示 标志 ， 暂 促 我 们 

变更 领域 模型 或 者 清理 底层 的 软件 系统 。 


11.5 铭记 


为 了 尽 可 能 发 挥 活 文 档 系统 的 优势 ， 请 保持 其 一 致 性 ， 并 确保 单 
个 可 执行 需求 说 明 易于 理解 ， 并 且 任 何人 都 能 方便 地 访问 ， 包 括 商业 
用 户 在 内 。 

演化 并 使 用 统一 语言 ， 保 持 一 致 性 。 


随 着 系统 的 演进 ， 请 注意 见长 的 需求 说 明 ， 或 者 几 个 小 的 只 有 细 
微 差 别 的 需求 说 明 。 寻 1 找 更 高 抽象 级 别 的 概念 会 让 这 些 事情 更 容易 前 
释 。 

将 活 文档 系统 组 织 成 层次 化 结构 ， 可 以 很 容易 地 找 出 当前 迭代 的 
所 有 需求 说 明 ， 以 及 之 前 实现 的 所 有 功能 。 
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12% uSwitch 


uSwitch.com 是 英国 最 繁忙 的 网 站 之 一 。 网 站 比较 不 同 公司 及 产品 
的 价格 和 服务 ， 包 括 能 源 供应 商 、 信 用 卡 、 保 险 公司 。 他 们 软件 系统 
的 高 扩展 性 以 及 与 大 量 外 部 系统 的 复杂 集成 导致 了 很 高 的 复杂 度 。 

uSwitch 是 个 有 趣 的 案例 研究 ， 因 为 它 展示 了 一 个 拥有 独立 的 开发 
团队 和 测试 团队 、 按 瀑布 流程 工作 的 公司 ， 如 何 依然 能 在 问题 颇 多 的 
遗留 环境 中 转换 到 一 种 更 好 的 方式 ， 去 交付 高 质量 软件 。uSwitch 在 3 
年 的 过 程 中 彻底 地 改变 了 他 们 的 软件 交付 流程 。 

在 uSwitch， 我 采访 了 Stephen Lloyd, Tony To, Damon Morgan, 
Jon Neale 和 Hemal Kuntawala。 当 我 询问 他 们 的 软件 流程 时 ， 他 们 的 回 
答 基本 上 就 是 :“ 有 人 早上 提出 的 一 个 想法 ， 当 天 就 可 实现 并 上 线 。” 
我 早年 所 在 的 一 家 公司 的 软件 流程 也 是 如 此 ， 但 是 当时 几乎 每 天 都 会 
在 生产 系统 中 碰 到 许多 问题 。 而 在 uSwitch， 产 品 的 质量 和 交付 功能 的 
速度 都 很 令 人 羔 幕 。 


虽然 uSwitch 没 有 特意 实施 实例 化 需求 说 明 ， 但 他 们 现在 的 流程 包 
含 了 本 书 所 描述 的 几 个 最 重要 的 模式 ， 包 括 从 目标 获取 泄 围 、 协 作 制 
定 需求 说 明 ， 以 及 自动 化 可 执行 需求 说 明 。 为 了 改进 软件 开发 流程 ， 
他 们 经 常 寻找 并 解决 妨碍 提高 质量 的 问题 ， 从 而 专注 于 提高 产品 质 
Æo 

在 寻找 更 好 的 方式 使 开发 与 测试 相 一 致 的 时 候 ， 他 们 以 让 人 易 读 
懂 的 形式 实现 了 测试 的 自动 化 。 之 后 ， 他 们 发 现 测试 可 以 当 作 需 求 说 
明 。 使 用 可 执行 需求 说 明 让 他 们 能 更 好 地 合作 。 在 提炼 流程 的 过 程 
中 ， 他 们 不 得 不 让 持续 验证 更 可 靠 ， 这 又 帮助 他 们 提高 了 提炼 需求 说 
明 的 万 式 。 当 他 们 去 寻找 与 商业 用 户 合作 的 更 好 方式 时 ， 他 们 开始 从 
目标 获取 范围 。 


12.1 2 


2007 年 ，uSwitch 使 用 的 是 瀑布 开发 流程 ， 大 型 项 目 都 是 预先 做 大 
量 的 设计 。 新 的 CTO 在 2008 年 推动 团队 转型 敏捷 ， 他 们 引入 了 
Scrum，3 周 一 个 迭代 。2008 年 10 月 ，uSwtich 新 功能 进入 市 场 的 平均 时 
间 为 6 一 9 周 。 虽 然 对 瀑布 流程 来 说 ， 这 是 一 个 巨大 的 进步 ， 但 是 每 个 
sprint 还 包含 了 大 约 40% 的 未 计划 的 工作 。Scrum 最 好 应 用 在 跨 职能 团 
队 上 ， 但 是 由 于 他 们 的 开发 的 组 织 方 式 ， 他 们 并 未 真正 做 到 这 一 点 。 

QA 团队 和 开发 团队 是 分 开 的 。 因 为 测试 人 员 使 用 QTP (开发 人 员 
无 法 获得 相关 信息 ) ， 开 发 人 员 开 发 和 测试 人 员 测 试 都 没有 互相 沟通 
过 。 结 果 ， 开 发 人 员 发 现 很 难 知道 何 时 才 是 真正 的 完成 。 因 为 发 布 的 
标准 是 所 有 的 QTP 测 试 必须 通过 ， 测 坛 往往 是 流程 的 瓶颈 。 

sprint 最 后 的 部 署 流程 平均 需要 3 天 ， 这 主要 是 由 于 测试 ， 并 上 且 还 
存在 很 多 质量 问题 。 当 团队 使 用 短 迭 代 的 时 候 ，QTP 测 试 开始 需要 大 
量 的 维护 。Hemal Kuntawala 说 :“ 没 人 知道 他 们 做 了 什么 ， 他 们 完全 
是 在 浪费 时 间 。” 

这 致使 全 公司 的 精力 开始 专注 于 质量 ， 每 个 人 都 被 要 求 开 始 考 虑 
质量 问题 。 他 们 认识 到 开发 人 员 把 东西 交 给 测试 人 员 而 没有 任何 解 


释 ， 这 是 个 问题 ， 于 是 决定 合并 测试 团队 和 开发 团队 。 他 们 去 掉 了 不 
同 的 职称 ; 测试 人 员 成 为 有 特殊 专长 的 “开发 人 员 ”。 同 样 ， 需 要 专业 
数据 库 知识 的 任务 交 给 了 有 经 验 的 数据 库 开发 人 员 ， 测 试 人 员 则 认领 
需要 专业 测试 知识 的 任务 。 但 是 他 们 不 再 是 独自 负责 测试 了 。 程 序 员 
开始 寻找 更 好 的 方式 来 编写 单元 测试 和 功能 测试 。 团 队 决 定 使 用 
Selenium， 而 不 是 QTP， 这 样 使 测试 更 轻 量 ， 大 家 也 都 能 访问 到 。 这 
帮助 了 开发 人 员 和 测试 人 员 更 好 地 合作 ， 但 是 因为 Selenium 太 技术 相 
关 了 ， 这 样 的 变化 没有 带 来 和 商业 用 户 更 好 的 沟通 方式 。 

因为 uSwitch 没有 任何 可 靠 的 系统 文档 ， 而 这 个 系统 已 经 伦 了 10 年 
时 间 开 发 ， 所 以 遗留 的 商业 规则 单单 导致 理解 问题 。Kuntawala 说 : 

“有 一 天 ， 我 们 遇 到 一 条 能 源 ( 子 系统 ) 上 的 遗留 商业 规则 ， 而 我 
完全 不 了 解 ， 这 很 令 人 泪 表 。 我 需要 一 种 方式 让 我 们 不 需要 看 代码 和 
单元 测试 就 能 了 解 商业 规则 以 及 应 用 程序 的 工作 原理 。 而 且 单 元 测试 
并 没有 做 到 覆盖 所 有 的 东西 。Google 一 番 后 ， 我 们 发 现 Cucumber 能 
弥合 测试 与 描述 目标 功能 之 间 的 差异 。 我 们 可 以 用 易 懂 的 语言 来 描述 
我 们 需要 什么 ， 而 它 能 适 舍 于 开发 人 员 想 达到 的 从 外 到 内 的 方式 。” 

为 了 让 大 家 熟悉 新 工具 ， 他 们 开始 把 Selenium 测 试 转 到 Cucmber。 
这 么 做 仍然 是 测试 自动 化 ， 也 就 是 功能 完成 之 后 再 检查 ， 但 已 经 朝 着 
测试 先行 的 可 执行 需求 说 明 迈 出 了 第 一 步 。Jon Neale 解 释 道 : 

“Given-When-Then 格 式 的 Cucumber 测 试 迫 使 我 们 重 写 了 故事 ， 
明确 我 们 在 做 什么 ， 并 让 我 们 看 到 我 们 已 经 遗忘 的 东西 。” 

团队 开始 让 商业 利益 相关 者 了 解 不 同 的 Cucumber 场 景 ， 不 仅仅 为 
了 验证 边缘 情况 ， 而 且 还 为 了 指出 哪些 场景 比较 重要 ， 以 此 减少 范 
围 ， 避 人 免 “ 以 防 万 一 ”的 代码 。 

在 他 们 完成 从 Selenium 测 试 到 Cucumber 的 转换 并 和 商业 用 户 一 起 
审查 过 后 ， 他 们 发 现在 迭代 最 后 做 测试 完全 没有 意义 。Neale 说 : 

“我 们 意识 到 可 以 坐 下 来 通过 需求 说 明 工 作坊 来 获得 许多 东西 ， 清 
晰 地 勾勒 出 我 们 要 达到 什么 目的 以 及 如 何 才能 达到 。” 


接着 团队 引入 了 需求 说 明 工 作坊 ， 用 这 种 方法 来 和 商业 用 户 合 
作 ， 明 确 未 来 需求 的 验收 标准 。 这 显著 改善 了 组 内 的 沟通 。 开 发 人 员 
(此 时 测试 人 员 也 称 作 开 发 人 员 ) 开始 了 解 领域 知识 。 商 业 用 户 了 解 
边缘 情况 以 及 较 模 糊 的 用 户 使 用 场景 ， 因 为 开发 人 员 会 问 及 此 事 。 

这 种 改变 还 影响 了 工作 的 分 割 。 之 前 ， 工 作 大 多 按照 技术 任务 划 
分 。 用 那样 的 技术 分 块 ， 他 们 发 现 很 难为 每 个 任务 写 出 具体 的 验收 标 
准 。 改 变 后 团队 的 注意 力 从 完成 任务 转移 到 实现 功能 应 当 交 付 的 价值 
上 上， 他们 开始 从 用 户 的 角度 描述 故事 ， 这 使 得 讨论 并 说 明 各 工作 块 的 
验收 标准 变 得 更 容易 了 。 

新 的 组 织 结 构 还 能 让 他 们 更 频繁 地 发 布 软件 。 因 为 技术 任务 会 
相依 赖 ， 开 发 人 员 在 一 大 块 工作 完成 前 不 会 去 部 署 。 通 过 专注 于 用 户 
故事 ， 他 们 的 工作 块 更 小 、 更 独立 ， 并 且 可 以 更 频繁 地 发 布 。 


12.2 优化 流程 


随 着 可 执行 需求 说 明 数 目的 增加 ， 团 队 发 现 测 试 结果 不 可 靠 。 即 
使 系统 中 的 功能 是 正确 的 ， 环 境 的 问题 也 常常 导致 测试 失败 。 他 们 运 
行 测 试 的 环境 不 稳定 。 他 们 有 开发 环境 ， 测 试 环境 和 临时 环境 ， 但 是 
没有 一 个 适合 频繁 运行 可 执行 需求 说 明 。 

因为 开发 人 员 使 用 开发 环境 做 各 种 尝试 ， 所 以 这 个 环境 经 常 有 问 
题 。 测 试 环境 用 于 手动 测试 ， 按 需 部 署 。 两 次 部 署 间 会 有 多 个 改变 ， 
所 以 当 测 试 失败 时 ， 不 知道 是 什么 导致 了 问题 。 商 业 用 户 也 在 这 个 环 
境 中 进行 手工 测试 ， 这 会 影响 自动 化 Cucumber 的 测试 结果 。 临时 环境 
是 生产 环境 的 镜像 ， 用 于 最 终 部 署 的 测试 。 

uSwitch 又 创建 了 一 个 环境 ， 只 用 于 持续 验证 。 这 解决 了 稳定 性 问 
题 : 有 专门 的 环境 用 于 测试 ， 而 不 会 打扰 其 它 工 作 。 这 个 环境 由 他 们 
的 持续 构建 系统 自动 部 署 。 用 这 个 环境 ， 可 以 更 快 地 得 到 可 执行 需求 
说 明 的 反馈 ， 反 馈 结 果 也 明显 可 靠 很 多 。 

一 旦 解决 了 环境 问题 ， 排 除了 这 个 不 稳定 因素 ， 他 们 就 能 够 看 到 
哪些 测试 或 软件 的 哪 部 分 由 于 设计 而 导致 了 不 稳定 。 因 为 所 有 的 测试 


是 通过 用 户 界 面 执行 的 ， 运 行 测试 的 可 执行 需求 说 明 数 目的 增长 会 导 
致 粕 颈 。 有 些 测 试 很 慢 ， 有 些 测 试 不 可 靠 。 他 们 开始 去 除 不 可 靠 的 测 
试 ， 查 明 导 致 不 稳定 的 原因 并 做 改进 。 测 试 是 在 技术 层面 上 实现 的 ， 
因此 市 来 了 维护 问题 。 

团队 开始 重 写 测试 、 拆 分 ， 并 提升 抽象 层次 。Kuntawala 说 这 对 他 
们 来 说 是 迈 出 的 相当 大 的 一 步 : 

“ 当 我 们 刚 开始 编写 测试 的 时 候 ， 会 依赖 于 浏览 器 专 有 的 东西 ， 比 
如 ， 页 面 上 的 DOM 标 识 符 ， 但 是 这 是 会 变 的 。 我 们 习惯 了 Cucumber 
的 语法 与 功能 后 ， 开 始 用 真实 的 商业 语言 编写 测试 。 之 前 你 可 能 会 
说 ;用户 在 某 某 id 的 输入 框 里 输入 数字 100。’ 现 在 则 是 : “用户 输入 
有 效 金 额 。? 有 效 金 额 会 在 单独 的 测试 中 定义 。 编 写 了 这 个 测试 后 ， 你 
就 不 必 在 其 他 每 一 个 测试 中 显 式 地 进行 测试 了 。 有 效 金 额 的 测试 可 能 
尝试 负数 、 字 母 等 ， 但 是 这 些 都 从 所 有 其 他 测试 中 抽象 出 来 。 这 是 很 
大 的 一 个 进步 。 的 

为 了 降低 长 期 维护 成 本 ，uSwitch 团 队 开始 提炼 需求 说 明 ， 演 化 一 
种 供需 求 说 明 使 用 的 一 致 语言 ， 寻 找 缺 失 的 概念 ， 以 提升 抽象 层次 。 

可 执行 需求 说 明 有 了 相对 较 好 的 功能 覆盖 ， 加 上 稳定 的 持续 验证 
环境 ，uSwitch 团 队 对 他 们 的 代码 有 了 更 多 的 信心 。 但 是 他 们 的 测试 运 
行 还 是 很 缓慢 ， 没 有 带 来 他 们 所 期 望 的 快速 反馈 。 他 们 觉得 不 是 每 个 
测试 都 值得 做 自动 回归 检查 。 有 些 测试 在 开发 过 程 中 很 有 好 处 ， 但 是 
不 会 给 功能 审 来 好 处 。 

有 个 例子 : 发 送 延 误 的 邮件 。 他 们 在 实现 功能 的 时 候 自 动 运行 可 
执行 需求 说 明 ， 但 是 功能 开发 完成 后 就 禁用 这 些 测试 。 这 样 低 风险 的 
测试 不 会 在 持续 验证 流程 中 运行 。 这 给 了 他 们 更 快 的 反馈 ， 并 且 减 少 
了 测试 维护 成 本 。 下 次 有 人 开发 系统 这 部 分 的 时 候 ， 他 们 又 会 重新 启 
用 测试 ， 并 按 需 进行 清理 。 

运行 测试 或 验证 系统 是 否 能 上 绪 不 再 是 瓶颈 ， 现 在 部 署 到 生产 环 
境 成 了 流程 中 最 慢 的 部 分 。 开 发 人 员 和 运营 工程 师 结 对 一 起 分 析 什 么 
拖 慢 了 速度 。 最 后 发 现 是 部 署 前 的 测试 造成 了 拖延 。 有 些 测试 在 临时 


环境 超时 ， 这 些 需 要 运营 工程 师 重 新 运行 全 部 的 测试 。 通 过 找 出 环境 
的 不 同 之 处 并 重 写 测试 ， 使 它们 更 灵活 ， 开 发 人 员 将 整个 测试 的 执行 
时 间 从 2 小 时 减少 到 了 15 分 钟 左右 。 

结对 还 帮助 运营 工程 师 融 入 到 了 流程 中 。 之 前 ， 他 们 会 报告 测试 
失败 了 ， 但 是 他 们 的 报告 缺少 细节 。 一 旦 他 们 理解 了 如 何 解释 测试 结 
果 ， 出 问题 的 时 候 就 能 给 开发 人 员 提 供 更 有 意义 的 报告 。 

接 下 来 的 改变 是 让 商业 用 户 更 多 地 加 入 到 开发 过 程 中 来 。 虽然 此 
时 团队 使 用 用 户 故 事 作 计划 ， 但 是 用 户 故 事 是 他 们 自己 编写 的 。 商业 
用 户 开 始 和 开发 团队 一 起 编写 故事 ， 对 需求 说 明 承担 起 更 多 的 责任 。 
他 们 先 大 概 地 定义 价值 (用户 故 事 中 的 “为 了 ”) ， 然 后 开发 人 员 定 义 
解决 方案 (用 户 故 事 中 的 “我 要 ”) 。 商 业 用 户 还 开始 负责 举办 需求 说 
明 工 作坊 。 这 改善 了 团队 的 沟通 。Damon Morgan 解 释 道 : 

“他 们 以 前 脱离 了 流程 。 他 们 会 问 : “这 个 功能 我 们 可 以 有 吗 ? ;， 
然后 我 们 用 某 种 他 们 不 一 定 能 理解 的 奇怪 语言 记录 下 来 。 他 们 会 看 到 
这 个 任务 在 板子 上 挪动 ， 但 这 对 他 们 来 说 没有 任何 意义 。 在 我 们 开始 
举行 需求 说 明 〈 工 作坊 ) 并 和 他 们 深入 讨论 具体 交付 的 细节 ， 得 到 这 
些 故 事 可 执行 的 标准 并 和 他 们 一 起 编写 故事 后 ， 他 们 对 整 项 工作 的 主 
人 翁 意 识 增加 了 。 故 事 从 商业 用 户 那里 返回 来 ， 他 们 不 会 再 说 : ‘这 个 
功能 不 对 ， 而 更 多 地 会 说 : :我们 还 没有 全 团队 一 起 考虑 这 个 场景 。” 

有 了 商业 用 户 更 多 的 参与 ，uSwitch 的 团队 建立 了 信任 和 信心 。 这 
意味 着 不 再 需要 长 期 优先 级 排序 以 及 大 块 的 工作 。 这 也 意味 着 商业 用 
户 会 更 容易 接受 开发 团队 的 建议 。 

有 了 更 紧密 的 合作 和 更 多 的 信任 ， 商 业 用 户 提 出 的 开发 范围 也 不 
同 了 。 团 队 接 着 开始 把 需要 的 功能 分 解 成 了 一 些 可 发 布 的 小 块 功能 ， 
这 些 功能 仍然 能 为 业务 带 来 价值 。 

有 这 样 一 个 例子 ， 重 写 能 源 目录 的 流程 是 4 级 页 面 ， 包 含 能 源 供应 
商 和 计划 的 列表 。 他 们 不 是 一 次 性 将 它们 全 部 发 布 ， 而 是 一 次 重 写 一 
个 页 面 ， 把 页 面 和 其 它 服务 关联 起 来 ， 然 后 发 布 。 虽 然 这 种 方式 提高 
了 集成 成 本 (因为 新 页 面 要 和 老 页 面 集成 ; ， 但 是 由 于 发 布 更 早 ， 所 


以 他 们 获 益 不 小 。 重 写 目 录 的 一 个 原因 是 为 了 搜索 引擎 优化 : 一 次 发 
布 一 个 页 面 意味 着 Google 可 以 更 早 地 索引 页 面 。 团 队 还 发 现 ， 更 小 的 
发 布 可 以 降低 出 错 的 风险 。 如 果 出 了 问题 ， 可 以 标记 成 一 个 特殊 的 发 
布 。 更 小 的 发 布 更 容易 查 明 问题 的 原因 。 

当 团 队 在 一 个 迭代 内 有 多 个 交付 时 ， 在 迭代 最 后 签收 就 变 成 了 瓶 
颈 。 他 们 不 是 在 最 后 做 一 个 大 的 演示 ， 而 是 在 功能 的 一 个 可 发 布 的 部 
分 完成 时 就 把 新 功能 演示 给 商业 用 户 并 签收 。 

团队 发 现 不 再 需要 正式 的 需求 说 明 工 作坊 ， 取 而 代 之 的 是 非 正 式 
的 聊天 环节 。 做 小 块 的 工作 、 获 得 快速 的 反馈 让 团队 在 有 足够 的 信息 
开始 工作 时 能 够 提速 ， 甚 至 他 们 不 必 获 得 完成 任务 的 足够 信息 。 根 据 
Damon Morgan 的 说 法 : 

“一 开始 ， (需求 说 明 工 作坊 ) 会 议 很 长 很 大 ， 我 们 尝试 研究 大 量 
的 需求 。 现 在 真 的 是 :我 们 现在 就 开始 实现 这 个 功能 :， 并 且 是 相对 较 
小 的 功能 ， 因 此 我 们 会 和 相关 人 员 交 谈 。 整 个 团队 会 一 起 举行 类 似 于 
迷你 需求 工作 坊 的 东西 ， 但 是 真 的 只 是 谈话 ， 甚 至 不 需要 会 议 室 。 你 
获得 了 验收 条 件 ， 就 开始 着 手工 作 ， 并 且 更 快 地 展示 给 用 户 。 通 常 两 
天 就 可 以 完成 并 交付 ， 然 后 开始 下 一 个 。 我 们 在 一 个 迭代 内 可 以 这 样 
重复 多 次 。” 

因为 流程 让 开发 人 员 比 以 前 学 到 更 多 的 业务 领域 知识 ， 并 且 他 们 
不 再 因为 误解 业务 需求 而 导致 很 多 问题 ， 所 以 他 们 不 需要 事先 知道 很 
多 就 可 以 正确 地 完成 工作 。Stephne Lloyd 说 : 

“作为 一 个 团队 ， 我 们 比 以 前 更 好 地 在 一 起 舍 作 ， 并 能 更 好 地 理解 
业务 需求 。 一 字 不 差 地 记录 他 们 的 需求 就 显得 没 那么 重要 了 ， 因 为 我 
们 现在 对 领域 的 理解 比 一 年 前 要 好 得 多 。” 

最 终 ，uSwitch 的 团队 开始 按 需 部 署 ， 完 全 不 受 迭 代 的 限制 。 为 了 
更 好 地 演化 这 个 流程 ， 他 们 开始 经 常 监控 他 们 的 生产 系统 ， 追 踪 错 误 
率 和 新 功能 的 使 用 情况 。 这 些 附 加 的 可 见 性 为 被 忽视 的 部 署 问题 建立 
了 一 张 安全 网 。 


12.3 当前 的 流程 


经 历 了 这 些 改变 后 ， 开 发 流程 变 得 简单 多 了 。 现 在 是 轻 量 的 ， 并 
且 是 基于 流 而 不 是 基于 迭代 。 

每 日 站 了 立会 议 上 只 要 有 人 提出 新 的 想法 ， 就 会 进入 待 办 列表 。 任 
何人 都 可 以 提出 新 的 想法 ， 包 括 商 业 用 户 和 开发 人 员 。 新 想法 主要 是 
在 站 立会 议 上 讨论 并 排出 优先 级 。 提 出 想法 的 人 为 了 更 好 地 解释 他 的 
想法 ， 可 能 会 在 会 前 男 一 些 粗略 的 图 表 ， 或 准备 业务 案例 。 此 外 ， 除 
了 需要 和 外 部 合作 伙伴 签订 合同 ， 一 般 不 需要 大 量 的 预先 准备 。 

当 有 个 故事 获得 最 高 优先 级 时 ， 团 队 会 考虑 完成 这 个 故事 需要 哪 
些 步 又。 所 有 对 该 故事 有 兴趣 的 人 会 健 到 一 起 并 简要 地 讨论 一 下 到 底 
需要 什么 ， 并 写 下 验收 标准 。 过 去 ， 团 队 尝 试 在 这 些 会 议 上 编写 
Cucumber 测 试 ， 但 是 他 们 确定 做 Cucumber 测 试 所 用 语法 时 ， 使 用 的 方 
式 是 这 样 的 : 一 个 人 敲 键盘 ， 其 他 人 干 看 着 。 这 造成 了 讨论 的 中 断 。 

开发 团队 、 市 场 部 人 员 以 及 负责 Email 功能 的 团队 大 家 的 座位 离 得 
很 近 ， 所 以 他 们 不 需要 预先 知道 许多 细节 就 可 以 开始 工作 。 开 发 人 员 
会 开始 接手 这 个 用 户 故事 ， 频 繁 地 与 商业 用 户 交 谈 ， 询 问 更 多 的 信息 
或 重新 审视 验收 标准 。 

验收 标准 在 开发 过 程 中 转化 成 Cucumber 测 试 并 自动 化 。 开 发 人 员 
使 用 探索 测试 来 在 修改 前 理解 系统 的 现 有 部 分 。 有 时 他 们 使 用 客户 会 
话 日 志 来 理解 真实 用 户 如 何 与 网 站 某 个 特定 功能 进行 交互 。 基 于 此 ， 
他 们 开发 Cucumber 测 试 并 在 开发 过 程 中 捕获 需要 考虑 的 用 户 使 用 路 
径 。 他 们 通常 用 浏览 器 自动 化 工具 来 通过 用 户 界面 自动 化 测试 。 现 在 
不 再 有 手工 脚本 测试 了 ， 但 是 他 们 做 了 很 多 2 探索 测试 ， 包 括 尝 试 系统 
的 不 同 路 径 并 尝试 破坏 它 。 

一 旦 所 有 的 Cucumber 场 景 通过 了 ， 就 将 变更 部 署 到 发 布 环境 ， 然 
后 在 当天 某 个 时 候 再 推送 到 3 生产 环境 。 

一 般 来 说 ，uSwitch 团 队 不 会 跟 路 许多 技术 上 的 项 目 指 标 。 相 反 ， 
他 们 只 看 延迟 时 间 和 吞吐 4 量 。 他 们 更 关注 系 统 的 业务 性 能 和 功能 增加 
的 价值 。 因 此 ， 他 们 在 生产 环境 里 监控 转化 率 (conversion rate) 和 功能 
使 用 率 等 用 户 体验 指标 。 


我 访问 uSwitch 的 时 候 ， 他 们 的 团队 正在 抛弃 估算 。 估 算 在 商业 用 
户 不 信任 开发 团队 或 他 们 要 投入 大 量 工作 的 时 候 有 用 。 但 是 现在 ， 这 
些 情况 都 不 适用 于 uSwitch。 商 业 用 户 对 开发 有 了 较 多 的 认识 ， 对 开发 
人 员 也 比 以 前 信任 得 多 。 他 们 一 般 还 是 做 小 型 的 增 量 工作 。 估 算 一 件 
工作 需要 花费 多 少时 间 就 变 得 没 必要 了 。 


12.4 结 


在 uSwitch， 一 个 功能 的 平均 周转 时 间 (从 接受 开发 到 上 线 ) 现在 
是 4 天 。 当 我 采访 他 们 的 时 候 ， 他 们 不 记得 过 去 6 个 月 里 有 任何 严重 的 
生产 问题 ， 往 返 的 情况 也 很 少 发 生 ， 只 不 过 几 个 月 发 生 一 次 。2009 
年 ， 在 Agile Testing UK 用 户 组 Hemal Kuntawala 的 演讲 中 ， uSwtich 
的 一 个 开发 经 理 说 : “质量 大 幅 提高 了 ， 转 化 率 也 增长 了 。” 


注释 : 请 参考 http://skillsmatter.com/podcast/agile-testing/how-we- 


build-quality-software-at-uswitch.com 和 
http://gojko.net/2009/10/29/upgrading-agile-development-at-uswitch-com- 


fromconcept-to-production-in-four-dayso 


现在 整个 开发 流程 由 功能 所 预期 的 商业 价值 驱动 着 。 没 有 大 的 计 
划 和 大 的 发 布 ， 他 们 构建 小 的 增 量 ， 经 党 发 布 ， 并 监控 增 量 是 否 市 来 
商业 价值 。 因 为 他 们 的 商业 模型 依赖 于 即时 网 页 转化 率 ， 所 以 他 们 可 
以 很 容易 地 实现 这 种 评估 。 

从 Mark Durrand 和 Damon Morgan¢£Spa2010@ 上 的 演讲 中 ， 你 可 
以 看 到 一 些 流程 如 何 六 化 的 有 趣 度 量 。 


注释 : Qwww.slideshare.net/markdurrand/spa2010-uswitch 
12.5 训 


对 我 来 说 ， 这 个 故事 最 重要 的 一 个 方面 是 uSwitch 决 定 专注 于 提高 
质量 ， 而 不 是 尝试 实施 任何 特定 的 流程 (具体 参见 4.1.2 节 ) 。 他 们 没 


有 采用 一 种 带 来 巨大 改变 的 方式 ， 而 是 时 常 寻 找 最 重要 的 需要 改善 的 
事情 ， 并 立即 着 手 改 进 。 等 到 对 所 产生 的 变化 感到 满意 的 时 候 ， 他 们 
会 继续 观察 流程 ， 并 移 到 下 一 个 问题 。 

团队 意识 到 测试 是 瓶颈 ，QTP 成 本 太 高 ， 对 开发 人 员 来 说 太 答 
重 ， 这 促使 他 们 通过 功能 测试 自动 化 引入 了 实例 化 需求 说 明 ， 我 在 
4.1.3 节 中 曾 提 到 这 种 方式 。 他 们 最 初 使 用 Cucumber 是 将 其 作为 自动 化 
功能 测试 的 方式 ， 但 是 后 来 发 现 从 中 获 益 良 多 ， 因 为 这 让 他 们 在 自动 
化 测试 的 同时 ， 还 能 将 它们 保持 为 可 读 的 形式 。 这 使 得 他 们 有 关 需 求 
说 明 流 程 的 思路 完全 改变 了 。 

故事 的 另 一 个 大 的 收获 是 改变 ， 虽 然 改 变 一 开始 是 通过 一 个 工具 
驱动 的 ， 并 且 大 多 是 文化 上 的 。uSwitch 移 除了 测试 人 员 和 开发 人 员 之 
间 的 界限 ， 去 掉 了 测试 人 员 角 色 ， 确 保 所 有 的 团队 成 员 都 能 理解 质量 
问题 是 大 家 的 问题 。 他 们 开始 专注 于 交付 商业 价值 ， 而 不 是 完成 技术 
上 的 任务 ， 这 帮助 他 们 提高 了 商业 用 户 在 开发 流程 中 的 参与 度 。 没 有 
这 些 商 业 用 户 的 紧密 合作 ， 就 不 可 能 在 这 么 短 的 时 间 里 决定 构建 什 
么 ， 并 达成 一 致意 见 ， 然 后 实现 并 完成 验证 。 

商业 用 户 更 多 地 参与 进来 意味 着 他 们 开始 非常 理解 并 信任 开发 团 
队 ， 开 发 人 员 也 能 学 习 更 多 的 领域 知识 。 正 式 的 需求 说 明 工作 坊 是 构 
建 这 种 知识 的 重要 一 步 。 沟 通 改 善 了 ， 开 发 人 员 学 习 了 大 量 的 领域 知 
识 ， 正 式 工作 坊 就 不 再 必需 了 。 这 是 团队 知识 构建 后 流程 如 何 优化 的 
一 个 好 例子 。 

在 我 的 脑海 中 ，uSwitch 采 取 的 最 具 争 议 性 的 步骤 是 决定 在 功能 实 
现 后 禁用 不 太 重 要 的 测试 。 我 见 过 也 听 过 其 他 团队 的 别 的 想法 ， 而 他 
们 是 唯一 一 个 没有 频 葵 运 行 活 文档 系统 中 的 所 有 测试 的 团队 。 可 执行 
需求 说 明 对 他 们 来 说 绝对 是 可 执行 的 : 可 以 运行 它们 ， 但 不 是 非 运行 
不 可 。 团 队 发 现在 开发 一 个 功能 的 时 候 运 行 这 些 测试 有 很 大 的 价值 ， 
但 是 随 着 测试 个 数 的 增多 ， 较 慢 的 反馈 融 来 的 长 期 成 本 比 对抗 低 风险 
领域 的 功能 回归 要 高 。 这 可 能 是 因为 他 们 有 其 他 方式 来 对 抗 生 产 环 
境 ， 特 别 是 持续 用 户 体验 监控 系统 中 的 问题 。 


第 13 章 RainStor 


RainStor 是 一 家 英国 公司 ， 开 发 大 容量 的 数据 归档 和 管理 系统 。 
RainStor 的 案例 分 析 非 常 有 趣 ， 因 为 他 们 处 理 的 技术 领域 比较 复杂 ， 
数据 量 很 大 ， 对 性 能 的 要 求 也 很 高 ， 需 要 先进 的 压缩 和 数据 管理 算 
法 6 

这 家 公司 的 员工 人 数 少 于 30 人 ， 而 且 大 约 有 一 半 的 人 在 做 研发 ， 
因此 他 们 在 开发 与 支持 他 们 的 软件 时 必须 非常 高 效 。 所 有 开发 人 员 和 
测试 人 员 都 在 同一 个 Scrum 团 队 里 工作 ， 不 过 他 们 正在 考虑 分 成 两 个 
团队 。 

他 们 采用 实例 化 需求 说 明 的 过 程 是 非常 自然 的 ， 没 有 大 型 的 计划 
或 者 专业 术语 ， 而 且 主 要 由 测试 人 员 推 动 。Adam Knight 是 RainStor 的 
高 级 测试 人 员 ， 同 时 也 是 支持 团队 的 负责 人 ， 当 我 采访 他 时 ， 他 说 : 
“公司 的 其 他 人 都 不 知道 什么 是 验收 测试 驱动 开发 。” 尽 管 他 们 的 过 程 
几乎 包含 实例 化 需求 说 明 的 所 有 关键 要 素 ， 但 他 们 认为 那 只 是 他 们 土 
生 土 长 的 软件 开发 方法 。 他 们 使 用 实例 来 描述 需求 ， 将 它们 自动 化 成 
可 执行 的 需求 说 明 ， 并 且 频 繁 地 对 其 进行 验证 ， 以 建立 起 一 个 活 文档 
系统 。 他 们 实现 的 变革 可 以 让 他 们 的 开发 团队 规模 在 今后 3 年 中 扩大 两 
倍 ， 与 此 同时 还 提高 了 效率 。 


13.1 改变 流程 


3 年 前 ， 一 位 新 的 CEO 决 定 采 用 Scrum， 同 时 扩张 了 只 有 4 名 开发 
人 员 的 团队 ， 招 募 了 两 名 测试 人 员 和 一 名 测试 经 理 。Knight 说 ， 尽 管 
他 们 采用 了 和 迭代 和 每 日 站 立会 议 ， 但 他 们 的 过 程 实 际 上 还 是 小 型 瀑布 
模型 。 他 解释 道 : 

“在 sprint 开 始 时 我 们 会 有 一 个 很 大 的 需求 文档 。 它 既是 需求 文 
档 ， 也 是 技术 规范 ， 包 含 了 太 多 的 技术 细节 。 在 迭代 开始 时 未 对 文档 
做 任何 修改 。 随 着 迭代 的 推进 ， 开 发 有 时 会 超出 文档 的 约束 ， 而 测试 


仍然 遵守 文档 的 原 有 内 容 。 在 开发 过 程 中 文档 没有 随 着 开发 的 改变 而 
及 时 维护 ， 所 以 最 终 我 们 的 测试 用 例 与 实际 的 实现 会 有 所 不 同 。” 

除了 开发 和 测试 的 协调 问题 ， 他 们 还 遇 到 了 测试 执行 方式 的 问 
题 。 尽 管 他 们 有 一 些 自动 化 测试 ， 但 大 部 分 验证 都 是 测试 人 员 手 工 进 
行 的 。 随 着 产品 的 发 展 ， 手 动 测试 显然 无 法 满足 需求 。 尽 管 他 们 增加 
了 人 和 手 去 执行 手动 检查 ， 但 他 们 的 软件 要 处 理 大 量 的 数据 ， 手 工 检查 
成 千 上 万 的 返回 结果 并 不 可 行 。 

在 2007 年 年 末 ，Knight 担 任 了 该 项 目的 测试 经 理 。 他 想 让 测试 更 
加 有 效 ， 并 可 以 支持 开发 工作 ， 避 免 在 产品 开发 过 程 中 进行 手动 测 
试 。 他 们 实现 了 一 个 简单 的 自动 化 测试 工具 ， 可 以 让 他 们 更 早 地 在 过 
程 中 展开 测试 。 在 他 们 开发 相关 功能 的 同时 ， 他 们 还 可 以 制定 出 测 
试 。 这 帮助 他 们 保持 了 开发 和 测试 的 一 致 性 。 

功能 测试 自动 化 给 予 了 他 们 即时 的 价值 ， 因 为 迭代 结束 时 他 们 不 
再 有 成 堆 的 测试 任务 。 同 时 这 还 能 让 开发 人 员 更 快 地 获取 到 反馈 (诸如 
某 项 工作 是 否 完成 )， 避 免 由 于 测试 拖延 到 下 一 轮 迭 代 而 造成 的 流程 中 
断 。 

一 旦 团队 保持 了 测试 与 开发 的 一 致 性 ， 他 们 就 会 开始 注意 到 范围 
里 变 的 问题 ， 并 可 以 了 解 到 自己 何 时 完成 某 项 工作 。 开 发 开始 后 ， 他 
们 经 常 不 得 不 重 写 需求 。 之 前 迭代 中 的 有 些 工作 往往 会 以 名 为 “ 清 
理 ......” 的 用 户 故 事 的 形式 再 次 出 现 。 在 2008 年 的 夏天 ，Knight 邀 请 了 
David Evans 作 为 顾问 ， 帮 助 他 们 理解 如 何 改 进 。 

结果 ， 他 们 开始 使 用 用 户 故 事 来 描述 范围 ， 而 不 是 预先 使 用 大 
的 、 详 细 的 技术 需求 。 这 让 他 们 开始 从 业务 角度 去 考虑 验收 条 件 并 据 
此 衍生 出 测试 ， 而 不 再 是 以 被 告知 需要 实现 什么 功能 的 方式 来 获知 需 
求 。Knight 说 这 让 他 们 可 以 更 好 地 理解 范围 ， 并 让 他 们 对 自己 何 时 开 
发 完 某 个 功能 有 一 个 清晰 的 认识 。 

他 们 开始 把 故事 分 割 成 更 小 的 可 交付 项 ， 这 赋予 了 他 们 更 高 的 可 
见 性 ， 让 他 们 可 以 了 解 一 轮 迭 代 实 际 可 以 交付 什么 东西 。 这 帮助 团队 
更 好 地 管理 了 商业 用 户 的 期 望 。 


然后 团队 开始 使 用 实例 来 描述 满足 的 条 件 ， 甚 至 是 诸如 性 能 之 类 
的 需求 。Knight 解 释 道 : 

“我 们 为 性 能 测量 使 用 了 定义 良好 的 验收 条 件 。 例 如 ， 在 多 少 个 
CPU 的 情况 下 ， 系 统 必 须 在 10 分 钟 内 导入 一 定数 量 的 记录 。 可 以 是 开 
发 人 员 访 问 专 用 的 测试 硬件 ， 也 可 以 是 由 测试 人 员 执 行 测试 并 提供 反 
Tito y 

关注 用 户 故 事 可 以 让 商业 用 户 更 好 地 参与 对 即将 开展 的 工作 设 定 
期 望 ， 而 用 实例 描述 这 些 期 望 可 以 让 团队 客观 地 衡量 他 们 是 否 达成 了 
目标 。 

随 着 客户 基础 的 成 长 ， 他 们 有 更 多 客户 专用 的 场景 要 实现 。 在 
2008 年 年 末 ， 团 队 决 定 把 客户 作为 最 终 的 利益 相关 者 ， 并 让 他 们 参与 
到 需求 说 明 的 制定 过 程 中 。Knight 补 充 道 : 

“通常 客户 知道 他 们 想 要 在 产品 中 放 入 什么 功能 。 他 们 会 给 我 们 需 
求 ， 我 们 会 一 起 舍 作 获取 真实 的 数据 集 与 预期 目标 。 我 们 会 把 它 放 入 
到 测试 工具 中 并 用 其 驱动 开发 。” 

把 带 样本 数据 的 客户 专用 的 场景 放 入 系统 作为 验收 测试 可 以 确保 
团队 达成 他 们 的 目标 。 同 时 这 还 意味 着 团队 无 需 浪 费时 间 去 想 一 套 单 
独 的 验收 条 件 集 ， 并 可 以 防止 任何 由 潜在 误解 造成 的 无 谓 返 工 。 

当 实 际 客户 可 以 参与 实际 需求 的 制定 时 ， 这 样 的 过 程 效果 最 佳 。 
RainStor 主 要 与 经 销 伙伴 一 起 工作 ， 经 销 商 有 时 会 提出 一 个 没有 具体 
业务 用 例 的 需求 ，Knight 称 :“ 这 样 的 需求 是 最 难 的 。” 在 这 种 情况 
下 ， 他 们 会 向 经 销 商 询问 实例 ， 有 时 会 组 织 一 些 工 作坊 ， 与 客户 一 起 
在 开发 完 的 原型 上 检查 高 层次 的 实例 。 今 后 他 们 会 用 那些 高 层次 的 实 
例 去 驱动 范围 。 研 究 纸 质 原型 也 可 以 帮助 他 们 先 看 到 系统 的 输出 ， 改 
善 由 外 到 里 的 设计 。 


13.2 当前 流程 


目前 ，RainStor 研 发 团队 的 迭代 周期 是 5 周 。 他 们 的 Sprint 始 于 周 
二 ， 在 局 动 会 议 上 会 对 下 一 轮 和 迭代 将 要 开发 的 故事 进行 简单 的 检查 。 


他 们 会 利用 当天 的 剩余 时 间 详 细 说 明 那 些 故 事 。 开 发 人 员 、 测 试 人 
员 、 文 档 工 程 师 以 及 产品 经 理会 进行 协作 ， 充 实 需求 的 细节 ， 并 为 每 
个 故事 制定 一 些 基 本 的 验收 条 件 。 测 试 人 员 会 根据 会 议 记 录 写 下 验收 
条 件 ， 并 发 布 给 整个 团队 去 看 。 

故事 的 满意 条 件 发 布 后 ， 开 发 与 测试 会 并 行进 行 。 开 发 人 员 致力 
于 让 现 有 的 带 实例 的 需求 说 5 明 通过 测试 ， 同 时 测试 人 员 致 力 于 创建 更 
多 详细 的 测试 用 例 。 对 于 某 些 故事 ， 起 初 可 能 没有 目 动 化 任何 实例 。 
这 种 情况 下 ， 开 发 人 员 会 先 交 付 基本 的 功能 ， 而 测试 人 员 则 自动 化 更 
为 简单 的 实例 。 然 后 测试 人 员 继 续 开发 更 进一步 的 测试 ， 同 时 开发 人 
员 交 付出 确保 可 以 通过 那些 测试 的 功能 。 

当 功 能 实现 后 ， 测 试 人 员 会 执行 探索 性 测试 并 针对 系统 的 新 版 本 
运行 自动 化 测试 。 开 发 人 员 完 整 实现 故事 描述 的 功能 后 ， 测 试 人 员 会 
确保 所 有 测试 都 通过 ， 然 后 将 它们 集成 到 持续 验证 系统 中 。 

3 处 最 能 带 给 人 顿悟 的 地 方 

我 让 Adam Knight 挑 选 出 3 处 有 关 实 例 化 需求 说 明 最 重要 的 经 验 。 
下 面 是 他 的 描述 。 

开发 自动 化 测试 工具 时 ， 如 果 恰 当地 对 它们 进行 设置 ， 揭 示 出 背 
后 的 意图 ， 那 么 它们 就 可 以 转变 成 测试 文档 。 元 数据 可 以 让 测试 的 可 
读 性 更 好 。 我 们 会 生成 HTML 格 式 的 报表 ， 列 出 执行 过 的 测试 以 及 它 
们 的 意图 。 调 查 任何 回归 失败 的 原因 变 得 更 加 容易 。 你 可 以 更 容易 地 
解决 冲突 ， 因 为 你 不 用 回头 去 看 文档 就 能 了 解 它 的 意图 。 

验收 条 件 以 及 带 实例 的 需求 说 明 是 故事 创建 过 程 的 一 部 分 ， 它 们 
就 是 需求 。 你 可 以 用 轻 量 级 的 故事 开始 。 一 旦 拥有 了 测试 ， 那 么 测试 
通过 就 意味 着 需求 已 经 满足 。 你 无 需 参考 任何 其 他 东西 就 可 以 找到 需 
求 。 如 果 将 来 有 需求 会 引起 冲突 ， 我 们 马上 就 能 发 现 哪些 修改 影响 了 
现 有 功能 。 这 让 我 们 可 以 持续 地 对 需求 进行 维护 。 我 们 总 是 可 以 知道 
产品 对 所 实现 的 需求 支持 得 如 何 。 如 果 测 试 开始 失败 ， 我 们 马上 就 可 
以 知道 哪个 需求 没 能 符 舍 预期 。 


测试 以 及 测试 结果 是 产品 的 一 部 分 。 你 应 该 把 它们 与 产品 一 起 保 
存在 版 本 控制 系统 中 。 我 们 会 测试 不 同 的 分 支 和 版 本 ， 并 且 需 要 执行 
那些 适 舍 于 分 支 的 测试 。 

有 些 测试 会 涉及 非常 大 的 数据 集 ， 或 者 需要 检查 性 能 ， 因 此 他 们 
把 持续 验证 分 成 了 3 个 阶段 : 常规 构建 、 通 宵 构 建 以 及 周末 构建 。 常 规 
构建 少 于 1 个 小 时 。 上 比较 慢 的 检查 会 通宵 运行 。 检 查 非 常 大 的 数据 集 ， 
通常 是 客户 场景 ， 只 在 周末 运行 。 由 于 这 种 反馈 很 慢 ， 他 们 只 在 功能 
稳定 时 才 会 把 测试 加 入 到 通宵 构建 或 周末 构建 包 中 。 当 开发 人 员 发 布 
部 分 功能 时 ， 他 们 会 尽 可 能 在 自己 的 机 器 上 运行 测试 。 测 试 人 员 会 运 
行 那些 需要 专门 硬件 的 测试 ， 并 给 开发 人 员 提 供 反 馈 。 

在 适 代 的 最 后 一 周 ， 他 们 会 天 闭 所 有 没有 解决 的 问题 。 他 们 的 团 
队 会 确保 所 有 测试 都 在 适当 的 自动 化 包 中 运行 。 他 们 会 紧密 跟踪 利益 
相关 者 ， 修 正 那 些 已 知 的 问题 。 在 迄 代 的 最 后 一 个 周一 ， 他 们 会 运行 
最 后 的 回归 测试 并 举行 回顾 会 议 。 

因为 RainStor 是 一 家 相对 较 小 的 公司 ， 所 以 他 们 的 产品 工程 副 总 
裁 需 要 负责 分 析 及 其 他 诸多 事项 。 他 很 难 单 单 参加 所 有 的 需求 说 明 工 
作坊 ， 因 此 有 了 时候 测试 人 员 会 介入 ， 帮 助 他 做 一 些 分 析 任 务 。 测 试 人 
员 负 责 搜集 问题 列表 ， 并 在 编写 市 实例 的 需求 说 明 前 获得 澄清 。 


13.3 重要 的 经 验 教训 


尽管 开发 团队 的 规模 在 过 去 3 年 中 增加 了 两 倍 多 ，RainStor 的 团队 
仍然 相对 较 小 。 开 发 产品 、 支 持 已 有 客户 以 及 拓展 客户 基础 都 由 同一 
拨 人 负责 。 那 么 少 的 人 做 那么 多 的 事 ， 他 们 行事 必须 显著 有 效 。 下 面 
列 出 了 他 们 取得 的 成 就 及 其 方法 。 

实施 可 执行 的 需求 说 明 消除 了 维护 两 套 文档 的 需要 。 它 有 助 于 保 
持 测 试 与 开发 的 一 致 性 ， 并 可 以 消除 很 多 无 谓 的 返工 。 

切换 到 用 户 故 事 帮 助 他 们 让 商业 用 户 更 好 地 参与 进来 。 

从 商业 目标 中 获取 带 高 层 实 例 的 范围 ， 确 保 他 们 构建 出 了 正确 的 
产品 ， 并 且 没 有 浪费 时 间 去 开发 不 必要 的 功能 。 


让 客户 协作 进行 需求 说 明 帮 助 他 们 让 过 程 更 加 有 效 ， 因 为 他 们 从 
一 开始 就 获取 到 了 验收 条 件 ， 这 可 以 确保 他 们 达成 目标 。 

过 去 3 年 中 他 们 在 逐步 改善 ， 但 他 们 并 没有 任何 大 型 的 计划 ， 也 没 
有 强制 实施 任何 特定 的 过 程 。 同 其 他 许多 故事 一 样 ， 他 们 总 是 在 寻找 
下 一 处 可 以 改善 的 地 方 ， 在 社区 中 搜寻 好 的 想法 帮助 他 们 进行 改善 ， 
然后 想 办 法 在 他 们 特殊 的 背景 里 进行 实施 。 这 让 他 们 实施 了 几 个 不 同 
寻常 的 实践 ， 比 如 只 在 系统 稳定 时 才 执 行 手动 测试 ， 并 使 用 自制 工具 
从 元 数据 中 建立 起 活 文档 。 

特定 的 背景 使 他 们 无 法 使 用 任何 更 为 流行 的 工具 来 取得 同样 的 效 
果 ， 因 此 他 们 开发 了 一 个 工具 帮助 他 们 更 有 效 地 进行 工作 。 他 们 从 过 
程 入 手 ， 并 开发 了 一 个 工具 为 其 提供 支持 。 

对 我 而 言 ， 这 个 案例 的 主要 经 验 是 在 进行 改善 时 要 把 重点 放 在 重 
要 的 原则 上 ， 仪 把 社区 上 流行 的 实践 作为 灵感 来 运用 。 


爱人 和 荷 华 州 助 学 贷 款 公司 是 一 家 财务 公司 ， 他 们 将 实例 化 需求 说 明 
的 理念 发 挥 到 了 极致 。 他 们 这 个 案例 十 分 有 意思 ， 因 为 他 们 的 活 文档 
系统 为 业务 市 来 了 竞争 优势 。 这 使 得 他 们 高 效 地 进行 了 主要 业务 模式 
的 变更 。 

爱人 和 荷 华 州 助 学 贷 款 公司 开发 团队 建立 并 维护 一 个 复杂 系统 ， 从 接 
受 贷款 申请 的 公共 网 站 ， 到 处 理 保险 核 保 (underwriting) 及 始 发 
(Origination) 的 后 台 系 统 。 此 外 ， 项 目的 复杂 性 主要 来 自 于 业务 的 数据 
驱动 特性 。 

我 采访 了 Tim Andersen、Suzanne Kidwell、Cindy Bartz 以 及 Justin 
Davis， 他 们 在 公司 改善 软件 流程 的 过 程 中 参与 了 多 个 项 目 。 从 改变 小 
项 目 到 重 写 整 个 保险 核 保平 台 ， 追 溯 他 们 如 何 启动 这 些 实践 非常 有 意 
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14.1 改变 流程 


2004 年 ， 爱 荷 华 州 助 学 贷 款 公司 开 发 团队 依照 书 上 的 方式 实施 了 
极限 编程 来 改善 软件 质量 。 第 一 个 项 目 上 线 后 ， 他 们 准备 用 类 似 于 以 
往 的 方式 来 处 理 缺陷 。 接 下 来 的 12 个 月 里 ， 新 系统 只 出 现 了 6 个 缺陷 。 
这 向 管理 层 证 明了 敏捷 开发 (尤其 是 测试 先行 是 一 个 很 好 的 理念 ， 
并 且 它 显著 地 改善 了 质量 。 

然而 ， 测 试 是 一 项 技术 活 。 团 队 使 用 了 HTTPUnit (用 于 对 网 站 做 
单元 测试 的 框架 ) 。 开 发 人 员 将 用 例 转 成 了 几乎 无 人 能 看 懂 的 
HTTPUnit 测 试 。 当 系统 上 线 时 ， 他 们 发 现 缺少 文档 。 之 后 他 们 聘请 了 
咨询 师 J.B.Rainsberger 来 帮助 他 们 找 出 其 中 的 问题 ， 并 帮助 他 们 使 用 一 
些 工 具 与 做 法 来 加 以 改善 。FitNesse 就 是 他 引入 的 一 个 工具 。 

2006 年 7 月 到 8 月 间 ， 团 队 以 使 用 FitNesse 捕 获 需 求 说 明 的 方式 宣告 
完成 了 第 一 个 项 目 。 这 个 项 目 使 得 团队 学 到 了 如 何 使 用 工具 ， 同 时 还 
引导 他 们 重新 思考 如 何 编 写 可 执行 的 需求 说 明 。 业 务 分 析 师 有 技术 背 
景 ， 结 果 他 们 与 开发 人 员 编 写 的 需求 说 明太 过 于 技术 化 。 这 带 来 的 后 
果 是 商业 用 户 无 法 理解 。Justin Davis 对 此 问题 的 解释 是 : 

“我 做 为 业务 分 析 师 能 够 看 到 并 阅读 它们 ， 我 们 仍然 在 编写 测试 ， 
然而 团队 的 其 他 业务 人 员 基 本 无 法 理解 这 些 测 试 。” 

要 重 写 整个 保险 核 保 平台 并 将 之 前 在 纸 上 手 工 完成 的 许多 工作 自 
动 化 、 还 仅仅 是 大 量 工作 的 开始 。 接 下 来 的 项 目 将 需要 花费 整个 团队 3 
年 的 时 间 ， 这 个 团队 包括 6 个 开发 人 员 、2 个 测试 人 员 、1 个 业务 分 析 师 
以 及 1 个 商业 用 户 。 他 们 引入 了 一 名 咨询 师 来 帮助 改善 团队 与 商业 用 户 
的 沟通 。Tim Andersen 说 : 

“David Hussman 说 我 们 应 该 加 倍 努 力 使 测试 写 得 更 清晰 明了 ， 这 
样 我 们 无 需 解 释 ， 业 务 人 员 也 能 够 轻易 读 懂 。 但 是 这 并 非 轻 而 易 举 的 
事情 。 我 们 需要 转变 思维 ， 需 要 更 强 的 业务 理解 能 力 ， 还 需要 更 多 地 
了 解 系统 应 当 如 何 运 作 ， 并 就 此 进行 沟通 ， 而 不 仅仅 是 只 了 解 技术 需 
求 。 4 

随后 ， 他 们 开始 以 用 户 角色 来 描述 系统 ， 这 样 可 以 考虑 不 同 种 类 
的 用 户 是 如 何 与 系统 交互 的 。 


他 们 不 再 使 用 通用 的 用 户 ， 而 开始 更 多 地 考虑 不 同 用 户 使 用 系统 
的 目的 ， 他 们 想 要 从 中 获得 什么 以 及 将 会 如 何 使 用 。 这 使 得 业务 利益 
相关 者 更 多 地 参与 进来 ， 并 能 为 团队 提供 更 有 意义 的 信息 。Tim 
Andersen 在 2010 年 的 code Freeze 大 会 上 的 六 讲 里 提 到 了 不 少 他 们 使 用 
的 关于 用 户 角色 的 好 例子 。 


注释 : 


(Dhttp://timandersen.net/presentations/Persona_ Driven_Development.pdf 


14.2 优化 流程 


由 于 他 们 之 前 的 可 执行 需求 说 明 非 常 技术 化 ， 所 以 自动 化 层 非 常 
复杂 且 难 以 维护 。 测 试 将 技术 化 组 件 换 述 为 大 流程 的 一 部 分 ， 因 此 他 
们 必须 通过 伪造 用 户 流程 的 某 些 部 分 才能 完成 自动 化 。Tim Andersen 
说 测试 结果 也 不 可 靠 : 

“测试 通过 了 ， 然 而 软件 却 无 法 使 用 。 测 试 在 撒谎 (ARE) 。 例 
如 ， 一 个 18 周 岁 以 下 的 借款 人 却 可 以 借款 。 我 们 将 会 写 一 个 测试 ， 如 
果 借 款 人 小 于 18 周 岁 ， 测 试 会 提示 : “没有 共同 签署 人 的 情况 下 你 不 允 
Ham. 而 如 果 更 改 借款 人 的 出 生年 月 ， 使 其 大 于 18 周 岁 ， 测 试 将 提 
Mm: “你 可 以 借款 ， 无 需 共 同 签署 人 。: 这 样 测 试 就 通过 了 ， 然 而 当 我 
们 在 浏览 器 里 试用 这 个 正在 开发 的 功能 时 ， 却 无 法 使 用 。 我 们 编写 了 
验证 规则 ， 却 没有 放 在 正确 的 地 方 ， 无 法 起 到 真正 的 作用 。 我 们 的 测 
试 代码 所 测试 的 是 :虚幻 的 状态 '。>” 

商业 用 户 不 信任 可 执行 需求 说 明 的 测试 结果 ， 因 此 也 不 觉得 测试 
很 重要 ， 这 也 是 妨碍 他 们 更 多 参与 其 中 的 另 一 个 障碍 。Andersen 说 : 

“双方 都 很 有 挫败 感 。 我 们 质疑 他 们 : “为 什么 不 评审 测试 ， 为 什 
么 不 重视 测试 ? MANLAR EE: “为 什么 开发 人 员 写 
的 测试 通过 了 ， 而 软件 却 无 法 使 用 ? 他 们 不 相信 这 些 测试 。” 

为 了 跑 通 整个 产品 流程 ， 团 队 重 整 了 可 执行 需求 说 明 的 自动 化 
层 ， 不 再 使 用 虚假 状态 。 需 求 说 明 新 的 自动 化 方式 非常 适应 描述 系统 


所 使 用 的 用 户 角 色 。Andersen 说 : 

“我 经 常 使 用 ‘虚幻 的 状态 ;这 一 词 ， 目 的 是 为 了 使 开发 人 员 明 白 那 
些 不 使 用 正确 切入 点 的 测试 是 无 法 取得 我 的 信任 的 。 虚 幻 状 态 的 其 他 
症状 是 ‘fixture 太 笨重 *，fixture 应 该 没有 太 多 逻辑 ， 应 该 相当 轻巧 。 使 
用 角色 有 助 于 我 们 找到 正确 的 抽象 级 别 ， 以 便 在 系统 中 找到 恰当 的 切 
入 点 。 未 使 用 角色 之 前 ， 我 们 选择 的 切 入 点 往往 不 够 恰当 ， 结 果 导 致 
了 出 现 笨重 的 fixture， 而 且 容易 出 现 ‘ 虚 幻 状 态 '"。>” 

团队 依照 角色 的 活动 来 组 织 自动 化 。 每 个 角色 都 以 fixture 的 形式 
在 自动 化 层 实现 ， 并 使 用 HTTP 请 求 与 服务 器 交互 ， 其 本 质 上 就 是 不 打 
开 浏 览 器 却 达 到 与 使 用 浏览 器 一 样 的 效果 。 这 不 但 极度 简化 了 自动 化 
层 ， 而 且 还 使 得 测试 结果 更 加 可 靠 。 使 用 这 种 方式 后 有 些 测试 开始 出 
现 错误 ， 团 队 因 此 发 现 了 原先 并 未 注意 到 的 缺陷 。 大 约 在 2007 年 5 月 
份 ， 测 试 结果 变 得 可 靠 多 了 ， 并 且 自 动 化 层 也 更 加 容易 维护 。 
Andersen 补 充 说 : 

“将 测试 代码 更 改 为 依赖 应 用 程序 设置 ‘贷款 ’ 的 状态 ， 这 样 一 来 就 
暴露 了 缺陷 ， 我 们 就 有 机 会 做 修复 ， 并 且 '‘ 伪 绿色 ’ 症 状 也 销声匿迹 
了 。 而 且 还 极度 降低 了 测试 的 维护 成 本 。>” 

只 要 可 执行 的 需求 说 明 用 于 描述 业务 功能 的 措辞 是 商业 用 户 能 够 
理解 的 ， 那 么 自动 化 层 就 会 变 得 简单 很 多 : 与 业务 领域 代码 相关 联 。 
它 还 使 得 需求 说 明 更 有 相关 性 ， 因 为 测试 的 流程 完整 并 且 不 再 产生 “ 假 
阳性 ”的 误导 。 

随 着 测试 个 数 的 增加 ， 反 馈 开 始 变 慢 。 许 多 慢 的 偏 技术 化 的 测试 
是 通过 浏览 器 进行 的 。Andersen 说 依照 角色 来 看 待 整个 系统 有 助 于 减 
少 此 类 问题 : 

“我 们 使 用 FitNesse 作 为 配置 watiJ( 一 个 UI 自 动 化 库 ) 的 工具 。 未 使 
用 角色 之 前 ， 我 们 使 用 浏览 器 进行 测试 是 不 得 已 而 为 之 的 ， 因 为 :我们 
必须 这 么 测试 才能 确保 功能 确实 没 问题 '。 此 类 浏览 器 测试 层 出 不 
穷 。 ia 


团队 使 用 “角色 ” 重 写 了 浏览 器 测试 ， 这 显著 地 改善 了 反馈 时 间 。 
新 的 自动 化 层 直接 发 出 HTPP 请 求 ， 无 需 每 次 都 打开 浏览 器 。 他 们 还 研 
究 了 如 何 取 代 SQL Server， 在 内 存 数据 库 中 运行 测试 ， 但 是 他 们 最 终 
决定 在 真实 的 SQL 数据 库 中 使 用 索引 来 提高 性 能 。 团 队 将 持续 验证 流 
程 分 成 几 个 模块 ， 以 便 更 好 地 观察 是 什么 使 得 测试 变 慢 。 

当 进 行 需求 变更 时 ， 团 队 开始 考虑 如 何 与 原 有 的 需求 说 明 集 成 ， 
而 并 非 每 次 都 创建 新 的 需求 说 明 。 这 减少 了 测试 的 个 数 并 有 助 于 避免 
不 必要 的 配置 工作 。Andersen 解 释 道 : 

“我 们 开始 考虑 场景 。 一 个 新 的 功能 可 能 不 是 独立 的 ， 它 有 可 能 是 
对 一 组 场景 的 变更 。 对 此 ， 我 们 不 是 为 每 个 需求 编写 新 的 测试 ， 而 是 
以 目前 系统 所 具有 的 上 下 文 来 考虑 问题 ， 并 且 考 虑 :需要 改变 哪些 测 
试 ' 而 不 是 需要 编写 哪些 新 的 测试 '。 这 样 就 不 会 增加 构建 的 时 间 。” 

这 还 帮助 他 们 开始 重组 需求 说 明 以 便 减 少 测试 的 个 数 。 他 们 会 寻 
找 较 小 的 部 分 的 需求 说 明 ， 并 将 其 合并 成 较 大 的 需求 说 明 。 他 们 还 会 
将 大 型 的 需求 说 明 分 解 成 几 个 较 小 的 、 更 专注 的 需求 说 明 。“ 基 本 上 必 
须 像 重 构 代 码 一 样 地 重 构 测试 与 测试 代码 。”Andersen 说 道 。 

爱 答 华 州 助 学 贷 款 公司 是 实例 化 需求 说 明 的 早期 使 用 者 ， 因 此 他 
们 不 得 不 使 用 还 未 成 熟 的 工具 ， 这 些 工 具 多 次 妨碍 了 协作 。 因 为 团队 
使 用 的 是 开源 工具 ， 所 以 他 们 可 以 依照 自己 的 开发 流程 来 更 改 这 些 工 
具 。 

在 他 们 将 可 执行 需求 说 明 放 入 版 本 控制 系统 之 后 ， 业 务 分 析 师 如 
果 不 使 用 开发 工具 就 无 法 直接 对 其 进行 更 改 。 开 发 人 员 为 FitNesse 编 写 
了 一 个 可 以 集成 版 本 控制 系统 的 插件 ， 这 样 业务 分 析 师 仍然 可 以 在 
wiki 上 更 改 需 求 说 明 。 

测试 的 个 数 变 得 越 来 越 多 ， 团 队 在 功能 回归 测试 方面 出 现 了 问 
题 。 本 应 该 被 现 有 的 测试 捕获 的 缺陷 却 成 了 漏网 之 鱼 ， 因 为 相关 的 测 
试 被 禁用 了 。 有 些 测 试 是 由 于 开发 人 员 不 确定 如 何 与 新 功能 衔接 而 被 
禁用 的 ， 而 有 些 是 因为 团队 在 等 待业 务 利益 相关 者 的 决定 而 被 临时 禁 
用 的 。 之 后 人 们 就 忘记 了 重新 启用 这 些 测试 ， 或 者 志 记 跟踪 讨论 。 爱 


荷 华 州 助 学 贷 款 公司 的 开发 人 员 为 禁用 的 测试 编写 了 一 个 自动 检测 
( 详 见 10.3.2 节 ) ， 这 样 可 以 在 每 个 迭代 结束 时 提醒 他 们 还 有 哪些 事情 
需要 后 续 的 行动 。 

他 们 使 用 JIRA 管 理 需 求 ， 使 用 FitNesse 管 理 可 执行 的 需求 说 明 ， 
因此 重新 安排 FitNesse 页 面 导致 了 JIRA 里 的 链接 不 再 起 作用 。 他 们 对 
FitNesse 做 了 扩展 ， 使 其 支持 关键 字 ， 然 后 在 JIRA 里 使 用 关键 字 链 接 
到 可 执行 需求 说 明 的 页 面 。 在 另 一 个 项 目 里 ， 他 们 采用 了 一 种 不 同 的 
方式 并 创建 了 一 个 业务 框架 。 该 业务 框架 是 一 组 FitNesse 的 页 面 ， 其 设 
计 初 衷 是 作为 稳定 的 文档 切入 点 ， 这 样 就 有 了 连 到 测试 的 内 部 链接 。 
这 是 好 的 活 文档 系统 的 开端 。Justin Davis 解 释 道 : 

“业务 框架 的 一 个 目的 是 创建 一 个 FitrNesse 的 前 端 ， 这 样 不 仅 业 务 
团队 能 够 使 用 ， 而 且 开 发 人 员 也 能 理解 当前 系统 的 内 容 。 事 实 上 , E 
提供 了 系统 如 何 运作 的 映射 图 。 因 此 ， 只 要 有 个 上 下 文 ， 比 如 知道 系 
统 如 何 运 作 ， 就 能 够 从 这 个 框架 里 找到 你 想 要 的 。 有 了 系统 工作 流 ， 
你 就 可 以 选择 想 要 查看 的 步骤 的 测试 与 需求 。” 

引入 业务 框架 并 且 确 保 可 执行 的 需求 说 明 保 持 相 关 性 并 确实 被 频 
繁 地 验证 ， 这 样 使 得 他 们 可 以 创建 一 个 有 用 的 活 文档 系统 。 他 们 有 一 
个 相关 的 信息 源 ， 任 何人 都 可 以 使 用 它 来 了 解 系统 的 功能 。 


14.3 竞 


有 了 如 此 完美 的 活 文档 系统 ， 他 们 就 能 够 非常 高 效 地 处 理 重 大 变 
更 。 在 项 目 结束 前 3 个 月 ， 公 司 的 业务 模型 突然 需要 变动 。 过 去 通常 是 
通过 出 售 债券 来 资助 贷款 。 由 于 2008 年 的 信用 危机 ， 债 券 出 售 失败 
了 。 由 于 公司 的 业务 受 技 术 驱 动 ， 因 此 业务 模型 的 变动 也 必须 在 软件 
中 相应 地 体现 。Andersen 说 活 文档 系统 帮助 了 他 们 ， 让 他 们 了 解 怎样 
才能 为 这 个 业务 变更 提供 支持 : 

“通常 情况 下 ， 我 们 使 用 债券 收益 资助 私人 助 学 贷 款 。 然 而 我 们 改 
变 了 业务 异型 ， 使 得 系统 中 所 有 的 资金 都 可 以 配置 。 这 样 ， 贷 款 出 借 
人 可 以 作为 资金 提供 者 ， 我 们 就 可 以 继续 为 学 生 提供 助 学 贷 款 。 这 绝 


对 是 一 次 对 系统 核心 的 大 翻修 。 有 这 个 新 需求 之 前 ， 系 统 甚 至 都 没有 
贷款 出 借 人 的 概念 ， 因 为 我 们 都 默认 爱 荷 华 州 助 学 贷 款 公 司 就 是 贷款 
出 借 人 。 

原 有 的 验收 测试 都 能 够 派 上 用 场 ， 只 需 说 这 是 我 们 对 于 资金 的 新 
的 需求 ， 做 适当 的 改变 后 就 可 立刻 发 挥 作用 。 我 们 针对 所 有 的 测试 讨 
论 了 影响 并 提供 资金 ， 这 样 他 们 仍然 可 以 运作 。 对 于 资金 不 足 的 情 
况 ， 或 者 资金 充足 但 某 个 学 校 或 某 个 出 借 人 无 法 使 用 等 情况 ， 我 们 做 
过 有 趣 的 讨论 ， 因 此 我 们 对 于 这 些 需 求 拟定 了 一 些 边缘 情况 ， 但 是 这 
只 是 为 了 新 的 资金 模型 可 配置 以 及 更 具 弹 性 。>” 

一 旦 他 们 理解 了 新 的 业务 模型 对 软件 膏 来 的 影响 ， 他 们 就 能 够 高 
效 地 实施 方案 。 据 Andersen 所 述 ， 如 果 没 有 活 文档 系统 就 无 法 快速 实 
施 此 类 变更 : 

“因为 我 们 有 很 好 的 验收 测试 ， 所 以 我 们 能 够 在 一 个 月 之 内 实施 解 
决 方案 。 如 果 没 有 这 些 测试 ， 任 何 系统 碰 到 类 似 的 情况 都 会 导致 开发 
中 断 ， 并 且 需 要 重 写 系统 。>” 

这 就 是 在 活 文档 系统 上 的 投资 回报 。 它 在 分 析 、 实 施 以 及 测试 业 
务 模型 变更 所 带 来 的 影响 等 方面 提供 了 支持 ， 同 时 可 以 让 他 们 快速 验 
证 系统 其 余部 分 是 否 受到 了 影响 。 


14.4 重要 的 经 验 教训 


他 们 一 开始 关注 工具 ， 之 后 很 快意 识 到 工具 无 法 帮助 商业 用 户 在 
流程 中 发 挥 作用 。 所 以 他 们 开始 以 用 户 的 角度 来 使 用 需求 说 明 。 这 使 
得 他 们 能 更 好 地 与 商业 用 户 沟通 ， 并 且 还 降低 了 测试 的 维护 成 本 。 当 
工具 妨碍 了 高 效 的 协作 ， 他 们 就 动手 更 改 工 具 。 这 也 是 使 用 开源 工具 
的 另 一 个 理由 。 

爱 傈 华 州 助 学 贷 款 公 司 实施 实例 化 需求 说 明 不 是 出 于 改善 质量 或 
自动 化 测试 的 目的 ， 而 是 出 于 建立 相关 文档 系统 的 需要 ， 以 便 使 系统 
更 加 高 效 ， 并 且 吸 引 商 业 用 户 参 与 其 中 。 他 们 大 手笔 投资 以 建立 好 的 


活 文档 系统 ， 而 结果 获得 了 丰厚 的 回报 。 活 文档 系统 帮助 了 他 们 实施 
业务 转型 ， 体 现 出 了 相当 的 威力 。 


第 15 章 Sabre Airline Solutions 


Sabre Airline Solutions 提 供 软 件 和 服务 来 帮助 航空 公司 制订 计划 、 
运营 以 及 销售 他 们 的 产品 ， 他 们 较 早 地 引入 了 极限 编程 与 实例 化 需求 
说 明 。 这 是 一 个 十 分 有 趣 的 案例 ， 因 为 他 们 在 一 个 大 型 项 目 和 庞大 的 
分 布 团 队 上 应 用 了 实例 化 需求 说 明 。 

这 个 项 目 是 Sabre AirCentre Movement Manger， 这 个 软件 系统 监控 
航班 运营 ， 并 在 发 现 问题 时 通知 相应 的 团队 ， 帮 助 他 们 调整 日 程 ， 将 
对 客户 和 航班 的 影响 最 小 化 。 据 Sabre 的 敏捷 教练 wes Williams 所 述 ， 

由 于 领域 的 复杂 度 和 质量 问题 ， 之 前 两 个 构建 类 似 系统 的 项 目 都 失败 
了 。 实 例 化 需求 说 明 帮 助 他 们 成 功 地 完成 了 这 个 项 目 。 


15.1 改变 流程 


实施 极限 编程 不 久 后 ， 因 为 领域 的 复杂 度 ，Sabre 的 团队 在 寻找 一 
种 能 够 在 极限 编程 实现 后 即 对 验收 测试 进行 说 明 并 自动 化 的 合作 方 
式 。Williams 说 他 们 最 初 尝试 的 是 偏 技 术 化 的 单元 测试 工具 。 不 过 这 
种 方式 并 没有 改善 合作 ， 并 且 还 不 能 重用 ， 所 以 他 们 放弃 了 。 

他 们 开始 寻找 一 种 驱动 合作 的 工具 。2003 年 ，Williams 发 现 了 
FIT， 也 就 是 第 一 个 广泛 使 用 的 自动 化 可 执行 需求 说 明 的 工具 。 他 的 团 
队 开 始 用 FIT 实 施 验 收 测试 ， 但 是 他 们 太 过 于 专注 工具 而 非 实 践 。 
Williams 说 这 并 没有 给 他 们 带 来 预期 的 合作 上 的 改善 : 

“我 们 喜欢 的 想法 是 客户 可 以 定义 测试 并 驱动 应 用 所 带 来 的 价值 。 
事实 上 ， 从 未 有 一 个 客户 用 HTML 编写 过 FIT 测 试 。 大 多 情况 下 测试 
是 由 开发 人 员 编 写 的 。 让 客户 做 到 这 点 并 不 是 那么 容易 。 测 试 人 员 使 
用 的 是 QTP。 这 无 法 带 来 协作 ， 因 为 开发 人 员 不 会 运行 QTP 测 试 也 不 
会 参与 编写 QTP 测 试 。” 


当时 编写 实例 化 需求 说 明 的 只 有 开发 人 员 ， 而 他 们 也 知道 这 无 法 

给 他 们 带 来 预期 的 好 处 。 为 了 改善 沟通 和 协作 ， 每 个 人 都 要 参与 其 
。 只 和 赁 一 小 部 分 人 是 无 法 独立 做 到 的 。 

有 个 产品 开发 高 级 副 总 裁 受 开发 团队 的 影响 ， 请 来 了 
ObjectMentor 的 顾问 来 给 大 家 做 培训 。 他 们 使 更 多 的 人 知道 了 实例 化 
需求 说 明 的 目的 以 及 可 以 从 中 获得 的 好 处 。 虽 然 他 们 没有 让 大 家 立刻 
开始 行动 ， 但 培训 使 更 多 的 人 对 这 个 实践 产生 了 极 大 的 兴趣 。 
Williams 说 : 

“不 是 所 有 人 都 能 接受 。 但 是 ， 仍 然 有 一 群 核心 的 人 相信 这 个 实 
践 ， 他 们 收获 很 大 。 而 不 接受 的 人 依然 一 如 既往 地 反对 。>” 

核心 的 这 群 人 从 一 个 相对 简单 的 Web 项 目 开始 ， 它 是 用 于 聚合 多 
个 软件 构建 信息 的 内 部 系统 。 为 了 尝试 实践 并 熟悉 工具 (这 些 2004 年 的 
工具 ， 在 今天 看 来 是 相当 的 落后 )， 团 队 选 择 了 FitNesse 来 协作 制定 可 
执行 需求 说 明 。 基 本 上 ， 他 们 编写 可 执行 需求 说 明 是 与 开发 并 行进 行 
的 ， 甚 至 在 开发 前 进行 。 项 目的 商业 利益 相关 者 是 公司 内 部 的 一 个 经 
理 ， 他 参与 审查 了 测试 。 团 队 一 开始 将 自动 化 层 看 作 二 等 测试 代码 ， 
不 太 关 心 代码 是 否 整 洁 ， 结 果 导 致 了 不 少 维护 问题 。 而 且 在 他 们 的 测 
试 需求 说 明 中 有 着 大 量 的 重复 代码 。Williams 说 : 

“我 们 学 习 到 应 该 保持 测试 代码 尽 可 能 简单 ， 不 要 出 现 重复 。 测 试 
(自动 化 层 ) 也 是 代码 ， 和 其 他 代码 一 样 。” 

开发 人 员 对 目 动 化 层 或 可 执行 需求 说 明 的 可 维护 性 不 大 关心 ， 因 
为 他 们 觉得 这 些 只 与 测试 相关 。 他 们 在 项 目 末 期 意识 到 这 种 做 法 给 项 
目 带 来 了 巨大 的 维护 问题 。 与 爱 荷 华 州 助 学 贷 款 公司 的 团队 类 似 ， 第 
一 个 项 目 让 Sabre Airline 团 队 学 习 了 如 何 使 用 工具 ， 并 看 到 了 他 们 自动 
化 可 执行 需求 说 明 的 方式 的 效果 与 局 限 性 。 这 样 他 们 也 知道 了 如 何在 
下 一 个 项 目 中 做 改善 。 

小 型 团队 更 好 地 理解 了 工具 的 局 限 性 ， 并 且 意 识 到 为 何 要 在 编写 
可 维护 的 实例 化 需求 说 明 上 投入 更 多 的 精力 ， 之 后 ， 他 们 开始 在 大 型 
的 并 且 具 有 一 定 风 险 的 项 目 上 应 用 这 个 流程 。 该 项 目 用 Java 重 写 


C++ 写 的 遗留 系统 ， 需 要 多 次 交付 。 这 是 一 个 数据 驱动 的 项 目 ， 并 且 
需要 支持 全 球 分 布 。 最 后 ，30 个 人 一 共 花 了 两 年 的 时 间 交 付 了 整个 项 
目 ， 并 且 是 由 分 布 在 两 个 大 洲 上 的 3 个 团队 共同 完成 的 。 

由 于 风险 ， 他 们 想 要 大 幅 提 高 测试 的 覆盖 率 与 测试 频率 。 于 是 他 
们 用 上 了 之 前 在 小 型 项 目 中 实施 的 做 法 。Williams 说 : 

“如 此 大 型 的 应 用 如 果 用 手工 测试 需要 几 个 月 。 我 们 想 要 防止 缺 
陷 ， 并 且 不 想 花 上 几 个 月 的 测试 时 间 。 于 是 我 们 采用 了 持续 测试 。 你 
不 可 能 每 天 在 如 此 大 型 的 应 用 上 手工 做 可 行 性 测试 。>” 

他 们 内 部 有 了 使 用 FitNesse 的 经 验 ， 因 此 参与 了 之 前 项 目的 人 开始 
编写 自动 化 功能 测试 。 他 们 邀请 了 商业 用 户 参 与 完成 测试 ， 并 期 望 这 
么 做 可 以 达成 预期 目标 。 


15.2 改善 协作 


他 们 分 成 了 3 个 团队 。 第 一 个 团队 负责 核心 功能 ， 第 二 个 负责 用 户 
界面 ， 第 三 个 负责 和 外 部 系统 集成 。 交 付 第 一 个 版 本 的 用 户 界 面 伦 了 4 
个 月 左右 。 商 业 用 户 看 到 界面 后 ， 核 心 团队 发 现 他 们 的 软件 遗漏 了 许 
多 客户 预期 。Williams 解 释 道 : 

“客户 看 到 的 界面 与 他 们 想象 的 完全 不 一 样 。 当 我 们 开始 编写 用 户 
界面 验收 测试 的 时 候 ， 用 户 界 面 的 测试 比 领域 的 多 很 多 ， 所 以 不 得 不 
修改 领域 代码 。 但 是 客户 认为 这 部 分 已 经 完成 了 。 他 们 有 自己 的 
FitNesse 测 试 ， 运 行 之 后 顺利 通过 。 人 们 认为 后 台 会 处 理 界 面 所 表现 
的 所 有 东西 。 有 时 对 于 前 端 来 说 可 用 的 查询 或 数据 检索 在 后 台 却 无 法 
支持 。>” 

他 们 意识 到 了 问题 出 在 团队 之 间 的 工作 分 配 上 。 客 户 具 有 先天 优 
势 可 以 周全 地 考虑 系统 细节 ， 但 前 提 是 让 他 们 “看 到 ”内 容 。 如 果 团 队 
不 能 交付 任何 用 户 界 面 ， 客 户 也 就 无 法 很 好 地 参与 到 团队 定义 需求 说 
明 的 工作 中 。 

项 目 开 始 6 个 月 后 ， 项 目 组 决定 重新 组 织 工 作 ， 好 让 团队 交付 端 到 
端的 功能 。 这 使 得 商业 用 户 能 和 所 有 团队 合作 。Williams 补 充 道 : 


“我 们 分 了 功能 组 之 后 ， 用 户 故 事 和 应 用 核心 已 经 非常 成 熟 了 ， 不 
会 有 故事 爆炸 性 增长 。 出 现 意外 的 几率 小 多 了 。” 

当 每 个 团队 开始 端 到 端 交 付 整 个 功能 的 时 候 ， 商 业 用 户 与 团队 协 
作 定 义 验收 标准 以 及 参与 到 举例 说 明 中 就 简单 多 了 。 

重组 工作 后 ， 团 队 发 现 他 们 需要 得 到 已 实现 故事 的 更 快 反馈 ， 所 
以 他 们 将 迭代 长 度 减 为 一 个 星期 。 虽 然 在 实现 前 就 编写 了 验收 测试 ， 
但 是 他 们 依然 将 其 视 为 测试 而 非 需求 说 明 。 测 试 人 员 负 责编 写 验 收 测 
试 ， 但 是 他 们 跟 不 上 这 么 短 的 迭代 。 为 了 去 除 壮 人 颈 ， 之 前 项 目 中 使 用 
FitNesse 的 小 组 建议 开发 人 员 应 该 帮助 编写 验收 测试 。Williams 说 测试 
人 员 一 开始 很 不 愿意 接受 : 

“一 开始 让 开发 人 员 答 案 编写 测试 颇 费 周折 ， 因 为 测试 人 员 认 为 他 
们 测试 做 得 更 好 。 我 想 这 是 因为 他 们 考虑 问题 的 角度 完全 不 同 。 事 实 
上 ， 我 发 现 自 从 开发 人 员 和 测试 人 员 一 起 讨论 测试 以 后 ， 编 写 出 来 的 
测试 会 比 他 们 某 一 方 独自 编写 时 好 得 多 。” 

Williams 意 识 到 这 需要 文化 上 的 改变 。 作 为 教练 ， 他 尽量 创造 环 
境 让 大 家 一 起 工作 ， 并 让 他 们 把 问题 暴露 出 来 。 当 测试 人 员 测试 落后 
的 时 候 ， 他 让 开发 人 员 来 帮忙 。 当 测试 人 员 抱 怨 开 发 人 员 不 知道 如 何 
编写 测试 的 时 候 ， 他 建议 团队 结对 编写 测试 。 

“他 们 体验 后 都 十 分 惊讶 :“ 哇 哦 ， 我 过 去 写 的 完全 跟 这 没 法 
比 ! ;你 需要 让 他 们 都 体验 一 下 。>” 

Williams 惊 讶 于 这 之 后 测试 人 员 和 开发 人 员 之 间 建 立 起 的 信任 : 

“信任 十 分 神奇 。 他 们 发 现 ， 一 起 做 可 以 做 得 更 好 ， 并 且 大 家 荣辱 
共 担 ， 因 而 不 会 有 人 从 中 作 梗 。 最 终 他 们 拥有 了 更 加 协作 的 环境 。” 

让 大 家 一 起 工作 不 仅仅 帮助 他 们 处 理 了 流程 中 的 瓶颈 ， 还 得 到 了 
更 好 的 需求 说 明 ， 因 为 不 同 的 人 可 以 从 不 同 角 度 考虑 问题 。 协 作 帮 助 
大 家 共享 知识 并 与 团队 里 其 他 人 之 间 逐 渐 建 立 起 信任 ， 长 期 来 看 这 使 


得 流程 更 加 高 效 。 


15.3 结 


虽然 之 前 两 次 尝试 重 写 遗 留 系统 都 因为 质量 问题 失败 了 ， 但 这 次 
项 目 一 开始 就 是 一 个 很 大 的 客户 上 线 了 ， 而 且 问 题 很 少 。 他 们 只 发 现 
了 一 个 严重 问题 ， 是 与 故障 切换 有 关 的 。Williams 说 实例 化 需求 说 明 
是 成 功 的 “关键 部 分 之 一 ”。 


数据 驱动 项 目的 关键 实践 
Wes Williams 分 享 了 在 数据 驱动 的 环境 中 编写 优秀 需求 说 明 最 重 
要 的 5 大 技巧 。 
隐藏 次 要 数据 。 


做 增 量 开发 时 ， 找 出 重复 部 分 ， 看 看 过 去 类 似 的 测试 并 清理 。 

像 对 代码 一 样 对 测试 进行 重 构 。 

隔离 自己 ， 不 要 依赖 于 数据 不 受 你 控制 的 第 三 方 。 在 航空 领域 
中 ， 系 统 最 终 要 和 许多 宿主 系统 通讯 。 他 们 可 能 也 有 测试 系统 ， 但 是 
其 数据 不 受 你 控制 。 你 的 测试 需要 与 他 们 通讯 ， 但 是 这 些 是 完全 隔离 
的 测试 。 在 自动 化 验收 测试 的 过 程 中 ， 这 部 分 需要 模拟 。 


15.4 训 


开发 人 员 通 过 推动 实例 化 需求 说 明 的 使 用 来 接触 测试 人员 和 商业 
用 户 ， 但 是 他 们 很 快 发 现在 封闭 的 小 组 中 专注 于 工具 是 不 会 成 功 的 。 
让 大 家 都 参与 进来 是 至 关 重 要 的 。 虽 然 培 训 不 会 让 大 家 都 开始 行动 ， 
但 也 给 了 他 们 一 个 共同 的 基准 ， 并 且 还 可 以 发 现 真 正 有 兴趣 尝试 新 想 
法 的 核心 人 员 。 

他 们 使 用 较 小 的 ， 风 险 较 低 的 项 目 开始 实验 工具 ， 并 且 发 现 编写 
和 维护 需求 说 明 及 自动 化 层 的 好 方式 。 人 参与 了 试验 项 目的 那 一 小 组 人 
在 大 项 目 里 的 更 大 团队 中 扮 汗 了 催化 剂 的 角色 。 

当 团队 开始 交付 系统 组 件 时 ， 商 业 用 户 不 能 正确 地 和 团队 协作 做 
后 台 组 件 ， 这 导致 了 大 量 的 重复 工作 ， 并 且 还 缺失 了 不 少 预期 功能 。 
在 他 们 重组 成 功能 团队 后 ， 这 个 问题 束 不 复 存在 了 。 


让 测试 人 员 和 开发 人 员 协 作 编 写 验收 测试 能 产生 更 好 的 需求 说 
明 ， 并 有 助 于 在 两 组 人 员 之 间 建 立信 任 。 

实例 化 需求 说 明 通 过 提供 清晰 的 开发 目标 和 持续 验证 ， 来 帮助 他 
们 征服 复杂 的 领域 。 


第 16 章 ePlan Services 


ePlan Services 是 位 于 科罗拉多 州 丹 佛 的 一 家 401k 退 休 金 服务 供应 
BO 。 他 们 的 业务 是 由 技术 驱动 的 ， 并 紧密 依赖 于 高 效 的 软件 交付 过 
程 。Lisa Crispin 是 在 那里 工作 的 一 名 敏捷 测试 人 员 ， 她 说 他 们 不 仅 使 
用 活 文档 来 处 理 复杂 的 业务 领域 ， 而 且 还 用 它 帮 助 软件 开发 人 员 和 业 
务 操作 人 员 之 间 的 知识 传递 。 


注释 : (401k 计 划 是 一 项 基金 式 的 养老 保险 制度 ， 指 的 是 美国 
1978 年 《国内 税收 法 》 新 增 的 第 401 条 k 项 条 款 的 规定 。 译 者 注 


该 公司 的 业务 模型 是 给 那些 小 型 企业 提供 服务 ， 由 于 运营 成 本 低 
廉 ， 因 此 他 们 更 具有 竞争 优势 ， 这 其 中 业务 流程 目 动 化 是 一 个 关键 因 
素 。2003 年 ， 他 们 意识 到 为 了 支持 业务 ， 他 们 的 软件 交付 过 程 必 须 有 
所 改变 。Crispin 说 :“ 当 时 我 们 的 软件 都 没 法 发 布 ， 因 为 有 太 多 的 质量 
问题 。” 

他 们 需要 交付 更 为 廉价 的 服务 ， 并 需要 将 业务 流程 自动 化 ， 这 些 
现实 需求 驱使 ePlan Services 公 司 走 上 了 一 条 改善 软件 开发 过 程 的 道 
路 ， 在 此 期 间 他 们 实现 了 实例 化 需求 说 明 的 大 部 分 想法 。 


16.1 改变 流程 


公司 说 服 了 Mike cohn 去 接管 开发 团队 ， 他 帮助 他 们 实现 了 
Scrum。 刚 开始 的 时 候 ， 他 们 在 每 轮 和 欠 代 的 最 后 两 天 执行 手工 测试 。 
团队 的 所 有 成 员 ， 包 括 测 试 人 员 、 开 发 人 员 以 及 数据 库 管理 员 ， 都 会 


去 执行 手工 测试 脚本 。 这 意味 着 五 分 之 一 的 迭代 时 间 都 花费 在 了 测试 
上 。 为 此 ， 他 们 决定 实现 测试 自动 化 。Crispin 说 ， 他 们 首先 要 纠正 的 
是 单元 测试 : 

“以 前 测试 人 员 找 到 的 缺陷 大 多 是 单元 级 的 。 我 们 在 这 上 面 投 入 了 
所 有 时 间 ， 因 而 没有 时 间 去 处 理 其 他 事情 。” 

当 开 发 人 员 习 惯 于 单元 测试 时 ， 测 试 人 员 开 始 进 行 功能 测试 自动 
化 。 没 有 开发 人 员 的 帮助 ， 测 试 人 员 只 能 通过 用 户 界 面 去 自动 化 测 
试 。8 个 月 后 ， 他 们 拥有 了 数 以 百 计 的 单元 测试 ， 而 且 还 自动 化 了 足够 
多 的 功能 性 冒 烟 测试 ， 这 使 他 们 不 必 再 执行 手动 回归 测试 以 检查 单元 
级 缺陷 。Crispin 说 这 让 他 们 可 以 从 更 宽广 的 视角 来 看 待产 品 : 

“我 们 很 快 就 发 现 ， 一 旦 开发 人 员 掌 握 了 测试 驱动 开发 ， 我 们 就 不 
会 再 有 那些 单元 级 的 缺陷 了 。 我 们 有 更 多 的 时 间 去 做 探索 性 测试 。 报 
告 的 缺陷 也 通常 是 因为 开发 人 员 没 有 理解 需求 ， 产 品 中 发 现 的 缺陷 往 
往 是 由 于 我 们 对 某 些 东西 没有 完全 理解 。” 

就 像 其 他 很 多 案例 一 样 ， 没 有 高 效 的 测试 自动 化 ， 团 队 就 没有 时 
间 去 处 理 其 他 任何 事情 。 一 旦 技术 上 的 单元 级 缺陷 不 再 引发 问题 ， 那 
么 他 们 就 可 以 看 到 其 他 问题 了 。 

尽管 他 们 有 一 些 自动 化 的 功能 性 测试 ， 但 这 并 不 足以 防止 问题 发 
生 。 由 于 这 些 测试 执行 缓慢 ， 只 能 通宵 运行 并 且 只 检查 了 测试 通过 路 
径 的 场景 。 团 队 开始 寻求 其 他 方法 来 自动 化 功能 测试 ， 以 便 更 快速 地 
运行 更 多 检查 。 他 们 找到 了 FitNesse， 但 是 这 种 自动 化 需要 开发 人 员 的 
帮助 。Crispin 说 让 开发 人 员 参 与 进来 是 一 个 挑战 : 

“程序 员 习 惯 于 因 编 写 产 品 代 码 而 得 到 奖励 。 按 照 Mike Cohn 的 建 
议 ， 我 拿 起 一 个 故事 卡 ， 走 到 正在 开发 这 个 故事 的 开发 人 员 那 里 ， 并 
问 他 我 们 是 否 可 以 结对 编写 FitNesse 测 试 。 下 一 个 sprint 我 会 拿 一 个 不 
同 的 故事 选 一 个 不 同 的 开发 人 员 。 我 们 马上 就 找到 了 一 个 缺陷 ， 实 际 
上 是 他 没有 真正 理解 需求 。 因 此 开发 人 员 马 上 看 到 了 那么 做 的 价值 。” 

协作 编写 测试 让 测试 人 员 和 开发 人 员 可 以 一 起 讨论 需求 ， 并 可 以 
帮助 他 们 编写 出 更 好 的 测试 。Crispin 说 这 消除 了 大 部 分 较 大 的 问题 : 


“在 实施 敏捷 后 的 一 年 里 ， 我 们 觉得 很 满意 ， 因 为 产品 里 没有 出 现 
很 严重 的 缺陷 。” 

同时 他 们 也 意识 到 了 协作 的 重要 性 。Crispin 说 : 

“这 种 方法 的 最 大 好 处 在 于 它 让 我 们 一 起 进行 讨论 ， 这 样 我 们 对 需 
求 就 会 有 共同 的 理解 。 这 上 比 测试 自动 化 本 身 更 为 重要 。 我 们 获得 了 协 
作 的 好 处 ， 而 产品 负责 人 对 验收 测试 驱动 开发 也 喜闻乐见 ”。 

高 效 的 功能 测试 自动 化 需要 测试 人 员 的 参与 ， 这 会 使 开发 人 员 与 
测试 人 员 之 间 的 协作 更 加 紧密 。 同 时 它 还 给 予 团队 明显 的 好 处 ， 帮 助 
团队 为 进一步 改善 而 建立 起 一 个 成 功 的 业务 案例 。 这 还 可 以 鼓舞 团队 
更 加 完善 他 们 的 过 程 ， 防 止 缺陷 进入 系统 而 不 是 等 它们 进 了 系统 后 再 
用 自动 化 测试 去 找 出 来 。 

更 进一步 ， 他 们 开始 把 验收 测试 作为 需求 说 明 ， 并 协作 定义 验收 
测试 。Crispin 与 他 们 的 产品 负责 人 一 起 预先 准备 实例 。 他 们 取得 了 一 
些 早期 的 成 功 ， 但 仍然 把 实例 看 作 是 功能 测试 。 一 致 性 测试 是 系统 最 
复杂 的 一 部 分 ， 当 他 们 使 用 这 种 方法 着 手 进行 一 致 性 测试 的 自动 化 
时 ， 他 们 过 度 地 说 明了 测试 ， 导 致 不 得 不 对 自己 想 要 达成 的 目标 考虑 
更 多 。Crispin 解 释 道 : 

“产品 负责 人 和 我 一 起 坐 了 下 来 ， 为 测试 算法 编写 了 所 有 的 
FitNesse 测 试 。 由 于 排列 组 舍 的 情况 太 多 ， 我 们 事先 花 了 好 几 个 sprint 
的 时 间 编 写 了 许多 非常 复杂 的 测试 。 当 开发 人 员 开 始 进行 编码 ， 看 到 
测试 时 ， 他 们 感到 困惑 。 因 为 这 让 他 们 看 不 到 系统 的 全 貌 。” 

他 们 意识 到 开发 人 员 无 法 事先 处 理 过 多 的 信息 。 经 过 几 次 试验 
后 ， 团 队 决 定 事 先 只 编写 高 层次 的 测试 ， 以 便 让 开发 人 员 能 掌握 全 局 
概况 。 当 一 名 开发 人 员 选 了 一 个 故事 ， 他 会 与 一 名 测试 人 员 进 行 结 
对 ， 编 写 主 要 逻辑 场景 的 测试 并 进行 自动 化 。 然 后 测试 人 员 会 通过 增 
加 更 多 实例 去 扩展 需求 说 明 。 测 试 人 员 利 用 自动 化 框架 来 探索 系统 。 
如 果 他 们 发 现 某 种 情况 会 让 测试 失败 ， 那 么 他 们 会 回去 找 开 发 人 员 将 
其 修复 。 这 种 方法 改变 了 他 们 将 验收 测试 当成 需求 说 明 的 方式 ， 
Crispin 说 : 


“起 初 我 们 有 一 个 模糊 的 想法 ， 认 为 自己 可 以 事先 编写 好 验收 测 
试 ， 然 后 把 它们 当成 需求 。 随 着 时 间 的 推移 ， 我 们 不 知道 自己 事先 需 
要 进行 多 详尽 的 测试 ， 多 少 测试 才 够 用 。 我 是 一 名 测试 人 员 ， 或 许 我 
可 以 不 断 地 测试 某 个 功能 ， 并 不 停 地 考虑 围绕 该 功能 还 需要 做 什么 测 
试 。 但 我 们 只 有 两 周 时 间 ， 因 此 我 们 必须 解决 如 何 把 风险 分 析 内 部 
化 ， 并 且 能 够 说 : 这 些 就 是 我 们 真正 需要 的 测试 ; 这 些 就 是 用 户 故 事 
真正 重要 的 部 分 ， 它 们 必须 正常 运转 。” 

当 他 们 的 思维 从 目 动 化 测试 转向 到 上 自动 化 需求 说 明 时 ， 很 明显 他 
们 试图 详细 说 明 并 进行 自动 化 的 物件 ， 其 主要 作用 是 充当 一 个 交流 工 
具 ， 而 不 是 回归 检查 的 工具 。 他 们 对 需求 说 明 进行 了 简化 和 提炼 ， 以 
确保 开发 人 员 在 需要 时 可 以 及 时 获得 足够 的 需求 说 明 。 

优秀 的 测试 设计 

Lisa Crispin 是 一 位 知名 的 敏捷 测试 人 员 ， 也 是 Agile Testing 一 书 
的 舍 著 者 。 我 问 她 怎么 做 出 优秀 的 验收 测试 设计 。 她 的 回答 是 下 面 这 
样 的 。 

优秀 的 测试 设计 关键 在 于 要 长 久 。 大 家 开始 进行 测试 ， 继 而 编写 
了 大 量 测试 。 突 然 之 间 ， 维 护 它们 的 投入 超过 了 测试 本 身 的 价值 ， 这 
就 不 是 好 的 测试 设计 。 

每 个 测试 必须 清楚 它 的 本 质 是 什么 。 

一 旦 发 现 重复 ， 就 必须 将 它 抽取 出 来 。 

测试 的 设计 应 该 由 程序 员 或 者 拥有 较 强 代码 设计 能 力 的 人 员 协 助 
完成 。 有 了 模板 ， 放 入 细节 就 很 容易 了 。 


16.2 活 文档 


如 果 团 队 把 实例 更 多 地 看 作 是 需求 说 明 而 不 是 测试 ， 就 会 意识 到 
它们 是 非常 强大 的 文档 。Crispin 说 当 他 们 调查 问题 时 ， 拥 有 一 个 活 文 
档 系统 帮助 他 们 节约 了 许多 时 间 。 

“我 们 接 到 过 一 个 电话 : 人 我 们 有 一 笔 贷 款 的 利息 金额 不 对 。 我 们 
认为 这 是 一 个 缺陷 。’ 我 可 以 查看 FitrNesse 测 试 并 输入 那些 数据 。 也 许 


是 需求 不 对 ， 但 目前 代码 就 是 那么 工作 的 。 这 可 以 节约 很 多 时 间 。>” 

有 一 次 ，ePlan 的 某 个 经 理 ， 同 时 也 是 一 名 高 级 开发 人 员 ， 决 定 回 
印度 ， 他 会 有 几 个 月 的 时 间 无 法 与 团队 一 起 工作 。Crispin 说 他 们 开始 
应 用 实例 化 需求 说 明 来 提取 他 独 有 的 系统 知识 : 

“每 当 出 现 奇怪 的 问题 ， 他 总 是 知道 怎么 进行 修正 。 因 此 我 们 必须 
了 解 他 掌握 的 系统 遗留 部 分 的 知识 。 我 们 决定 每 个 sprint 都 要 有 一 个 
人 人 花 些 时 间 去 仔细 检查 一 部 分 业务 流程 ， 并 记录 下 来 。” 

这 还 帮助 他 们 开始 记录 系统 的 其 他 部 分 。 尽 管 他 们 会 为 任何 正在 
开发 的 东西 编写 测试 ， 但 仍然 有 部 分 遗留 系统 没有 进行 测试 自动 化 ， 
有 时 候 这 会 引起 一 些 问 题 。 为 这 些 地 方 建立 起 一 个 自动 化 的 活 文 档 ， 
帮助 他 们 发 现 了 业务 流程 中 的 不 一 致 。Crispin 解 释 道 : 

“ 那 时 我 已 经 在 公司 待 了 4 年 ， 但 我 一 直 不 了 解 现金 会 计 是 怎么 工 
作 的 。 我 了 解 到 在 自动 化 程序 外 ， 我 们 有 5 个 不 同 的 银行 账户 。 这 些 账 
户 里 的 钱 通 过 电子 邮件 和 电话 转 来 转 去 ， 但 是 现金 数额 必须 平衡 。 一 
旦 发 生 不 平衡 ,会计师 需要 一 种 方法 去 做 调查 。 在 会 计 师 向 我 们 解释 
了 这 个 过 程 后 ， 我 们 在 wiki 上 记录 下 来 以 备 后 查 。 然 后 我 们 就 可 以 撰 
写 报告 ， 提 供 金 钱 转 入 转 出 系统 的 有 用 信息 。 现 在 ， 当 现金 失衡 时 ， 
会 计 师 可 以 利用 报告 找 出 问题 。” 

活 文档 系统 的 建立 帮助 开发 团队 分 享 了 知识 ， 让 他 们 学 习 了 业务 
流程 ， 同 时 还 让 业务 人 员 清 楚 地 了 解 到 系统 实际 在 做 什么 事情 。 把 东 
西 写 下 来 可 以 暴露 出 不 一 致 以 及 有 分 歧 的 地 方 。 在 本 案例 中 ， 它 让 大 
家 努力 地 从 业务 角度 去 考虑 系统 实际 上 在 做 些 什么 。 


16.3 当前 的 流程 


所 有 这 些 变 化 都 是 在 不 久 前 完成 的 ， 而 且 有 了 活 文 档 系统 ， 团 队 
就 有 了 一 个 相对 稳定 的 过 程 。 目 前 ， 团 队 由 4 名 程序 员 、2 名 测试 人 
员 、1 名 Scrum 大 师 、2 名 系统 管理 员 、1 名 数据 库 管理 员 以 及 一 名 经 理 
组 成 。 他 们 的 迭代 周期 是 2 周 。 每 个 sprint 开 始 前 两 天 ， 团 队 会 与 产品 
负责 人 及 项 目 干系 人 会 面 。 产 品 负责 人 会 介绍 下 一 个 Sprint 计划 完成 的 


所 有 故事 ， 他 们 会 在 白板 上 写 下 高 层次 的 测试 。 这 可 以 让 团队 针对 计 
划 提供 反馈 ， 并 可 以 在 实际 的 sprint 计 划 会 议 前 提出 问题 。 

在 这 种 业务 复杂 、 团 队 较 小 的 情况 下 ， 产 品 负责 人 是 一 个 瓶颈 。 
为 了 让 他 能 够 和 上 游 的 商业 用 户 一 起 工作 ， 测 试 人 员 需 要 接手 一 些 分 
析 工 作 。 产 品 负责 人 经 常会 事先 创建 一 个 “故事 检查 清单 ”， 包 含 故事 
的 目的 以 及 大 致 的 满意 条 件 。 对 于 那些 涉及 用 户 界 面 的 故事 ， 他 会 在 
故事 检查 清单 上 加 入 用 户 界 面 模型 。 对 于 那些 处 理 复 杂 算 法 的 故事 ， 
他 会 加 入 一 张 带 实 例 的 表单 。 

最 后 ， 产 品 负责 人 还 会 做 更 多 与 软件 无 天 的 工作 ， 因 此 他 经 音 疫 
有 足够 的 时 间 去 准备 会 议 。 为 了 解决 这 个 问题 ， 测 试 人 员 会 征 得 他 的 
同意 ， 直 接 与 上 游 的 利益 相关 者 接触 ， 并 同 他 们 一 起 制定 需求 说 明 。 

迭代 始 于 计划 会 议 ， 会 议 上 他 们 会 再 次 检查 故事 ， 产 品 负责 人 会 
回 从 任何 尚未 解决 的 问题 。 他 们 会 创建 界面 模型 并 使 用 实例 换 述 需 
求 。 测 试 人 员 会 将 那些 信息 与 故事 的 检查 清单 合并 起 来 ， 如 果 清 单 上 
的 检查 点 都 具备 了 ， 那 么 他 们 就 会 对 需求 说 明 进 行 提炼 并 放 到 wiki 站 
rato 

sprint 的 第 4 天 ， 两 名 测试 人 员 会 与 产品 负责 人 碰头 ， 仔 细 检 查 所 
有 的 需求 说 明和 测试 用 例 ， 以 此 确保 他 们 正确 理解 了 所 有 事情 。 这 让 
产品 负责 人 有 机 会 在 迭代 中 对 需求 说 明 以 及 团队 将 要 进行 的 工作 进行 
一 个 回顾 。 

一 旦 需求 说 明 开始 出 现在 wiki 上 ， 开 发 人 员 就 会 开始 着 手 实现 故 
事 ， 完 成 后 他 们 就 会 把 结果 展示 给 业务 人 员 看 。 

顿悟 之 处 

我 问 Crispin 实 例 化 需求 说 明 让 她 顿悟 的 地 方 是 哪里 。 她 的 回答 如 
下 。 

我 不 控制 质量 。 我 的 工作 是 帮助 客户 理解 质量 ， 帮 助 整 个 团队 定 
义 质 量 ， 确 保 万 无 一 失 。 

需要 开发 人 员 的 参与 。 


这 个 过 程 需要 耐心 。 我 们 必须 遵 慎 前 进 ， 不 要 试图 立刻 实施 所 有 
要 素 。 

像 FitNesse 这 种 工具 的 确 有 助 于 协作 。 也 许 你 觉得 它 是 技术 上 的 
东西 ， 会 帮助 你 进行 自动 化 ， 但 它 还 可 以 改变 团队 文化 并 有 助 于 更 好 
地 进行 沟通 。 

实例 化 需求 说 明 的 真正 价值 在 于 我 们 进行 交谈 了 。 


16.4 il 


由 于 他 们 的 商业 策略 ，ePlan Services 公 司 对 业务 流程 自动 化 以 及 
高 效 的 软件 交付 有 着 很 强 的 依赖 。 为 了 提高 质量 并 加 速 软件 交付 ， 他 
们 必须 放弃 手动 软件 测试 。 最 初 他 们 关注 于 功能 测试 自动 化 ， 但 接着 
他 们 发 现 由 协作 带 来 的 共识 可 以 引导 他 们 开发 出 更 好 的 软件 。 

刚 开始 ， 他 们 从 测试 的 角度 去 考虑 协作 ， 过 度 地 说 明了 测试 ， 这 
让 开发 人 员 很 难 将 那些 文档 当成 开发 和 目标。 之 后 ， 他 们 并 没有 覆盖 所 
有 可 能 的 数据 组 合 ， 而 是 只 说 明 那 些 关 键 实 例 ， 这 使 他 们 的 过 程 更 加 
高 效 ， 还 为 开发 人 员 及 时 提供 了 良好 的 需求 说 明 。 

有 了 一 套 针 对 系统 某 部 分 功能 的 比较 全 面 的 可 执行 需求 说 明之 
后 ， 他 们 就 立刻 意识 到 活 文档 是 多 么 有 用 ， 特 别 是 它 作 为 一 种 记录 专 
家 知识 的 方式 。 当 他 们 开始 记录 其 他 部 分 的 业务 功能 时 ， 具 有 一 致 性 
的 活 文 档 系 统 就 暴露 出 了 他 们 当前 业务 流程 中 的 错误 与 不 一 致 之 处 。 

活 文档 系统 可 以 让 软件 交付 过 程 高 效 得 多 ， 还 让 他 们 发 现 了 业务 
过 程 中 的 不 一 致 。 


第 17 章 Songkick 


Songkick 是 一 家 英国 的 创业 公司 ， 它 运营 着 Songkick.com， 一 个 在 
线 音 乐 的 消费 者 网 站 。 他 们 是 个 非常 有 趣 的 案例 ， 有 两 个 原因 。 首 
先 ， 跟 本 书 中 的 其 他 公司 不 同 ， 他 们 在 创业 阶段 就 开始 实施 实例 化 需 
求 说 明了 ， 那 时 尚 不 涉及 处 理 大 型 遗留 系统 的 问题 。 其 次 ， 跟 本 书 提 


到 的 其 他 大 多 数 项 目 也 不 一 样 ， 用 户 交 互 是 他 们 的 产品 中 一 个 最 重要 
的 因素 ， 根 据 对 用 户 如 何 使 用 网 站 的 观察 ， 新 功能 开发 很 强调 用 户 体 
验 。 

系统 的 复杂 度 大 多 源 自 于 许多 改善 用 户 体验 的 微妙 之 处 ， 以 及 他 
们 用 以 为 用 户 提供 丰富 体验 的 诸多 功能 。Songkick 实 施 实例 化 需求 说 
明 是 为 了 专注 于 交付 有 效 的 软件 ， 并 且 能 够 帮助 开发 团队 成 长 。 

“作为 创业 公司 ， 你 必须 始终 都 在 交付 价值 。” 他 们 的 CTO Phil 
Cowans 如 是 说 。 下 面 是 他 指出 的 实例 化 需求 说 明 最 大 的 好 处 : 

“我 们 可 以 更 快 地 获得 真正 想 要 构建 的 东西 ， 因 为 我 们 在 确定 要 构 
建 的 内 容 并 与 客户 沟通 的 整个 过 程 中 所 使 用 的 语言 同 测试 中 使 用 的 语 
言 是 一 样 的 。 这 有 助 于 减少 沟通 问题 。 我 们 不 希望 出 现下 面 这 种 情 
况 ， 开 发 人 员 回 头 来 说 : 我 们 做 的 是 对 的 ， 只 是 你 要 求 的 东西 不 对 。>” 

比 起 更 加 成 熟 的 公司 ， 对 于 一 个 创业 公司 来 说 ， 交 付 能 有 效 增加 
实际 价值 的 软件 显得 更 为 重要 。 实 例 化 需求 说 明 的 实践 帮助 Songkick 
从 软件 开发 投资 中 获得 了 更 多 的 价值 。 


17.1 改变 流程 


他 们 的 项 目 开始 于 两 年 半 以 前 。Cowans 说 ， 第 一 年 过 后 ， 团 队 开 
始 扩大 ,“ 一 张 办 公 时 已 经 坐 不 下 了 ， 没 法 所 有 人 都 坐 在 一 起 开发 ”。 
为 了 应 对 越 来 越 复杂 的 代码 库 以 及 不 断 扩张 的 团队 ， 他 们 决定 实施 测 
试 驱动 开发 。 他 说 : 

“开始 TDD 前 ， 我 们 发 布 新 代码 是 基于 我 们 相信 之 前 构建 的 系统 
都 正常 工作 。 但 是 不 久 我 们 明显 感到 需要 更 多 的 信心 ， 要 确信 当 我 们 
完成 某 项 功能 时 ， 它 确实 按 我 们 设想 的 工作 ， 并 且 没有 导致 回归 问 
题 。 很 明显 ， 如 果 我 们 找 不 到 一 种 方式 以 避免 长 期 存在 的 互相 妨碍 的 
问题 ， 需 求 沟通 的 问题 以 及 出 现 回归 的 问题 ， 那 么 我 们 的 发 展 速度 必 
定 会 变 慢 。” 

3 个 月 后 ， 他 们 发 现 TDD 是 比较 自然 的 方式 。 同 时 ， 他 们 开始 研 
究 看 板 与 用 户 故 事 的 想法 ， 这 引导 他 们 开始 在 业务 功能 上 应 用 TDD 原 


则 ， 并 开始 有 效 地 实施 实例 化 需求 说 明 。 他 们 整个 团队 喜欢 实验 不 同 
的 工作 方式 ， 所 以 他 们 可 以 心平 气 和 地 开始 做 党 试 。Cowans 解 释 道 : 

“我 们 联系 了 一 个 在 早期 项 目 中 使 用 过 看 板 的 人 ， 他 现在 是 正式 雇 
员 ， 但 此 前 是 项 目的 顾问 ， 并 非 正 式 雇员 。 通 过 他 我 们 相信 了 使 用 用 
户 故 事 是 可 行 的 ， 而 且 看 起 来 更 舍 理 。 将 这 些 加 入 我 们 的 流程 中 ， 这 
样 的 决定 仅仅 是 出 于 下 面 这 样 的 想法 : “已 经 有 人 使 用 这 个 技术 这 么 做 
了 ， 让 我 们 试 试 看 效果 怎样 。' 于 是 这 变 成 了 一 件 对 我 们 来 说 很 自然 的 
事情 。>” 

团队 开始 从 目标 获取 范围 ， 从 商业 价值 的 角度 来 驱动 用 户 故 事 。 
他 们 还 使 用 Cucumber 创 建 可 执行 需求 说 明 。Cowans 说 随 着 Cucumber 
使 用 得 越 来 越 好 ， 流 程 的 焦点 从 单元 测试 转移 到 了 业务 需求 说 明 上 : 

“一 开始 我 们 混 舍 使 用 Rails 测 试 框架 和 Cucumber。 我们 使 用 
Cucumber 驱 动 高 层 用 户 故 事 和 单元 测试 来 说 明 具 体 行为 。 随 着 时 间 
的 推移 ， 我 们 越 来 越 多 地 使 用 Cucumber， 并 找到 了 更 多 地 用 
Cucumber 来 描述 事情 的 方法 。” 

新 的 描述 方式 帮助 团队 专注 于 构建 真正 重要 的 软件 。Cowans 说 : 

“这 帮助 大 家 专注 于 我 们 做 事情 的 初衷 ， 并 看 到 我 们 所 做 的 事情 的 
价值 。 同 时 还 帮助 大 家 避免 将 时 间 浪 费 在 构建 不 需要 的 东西 上 。 所 有 
人 都 从 同一 个 方向 来 解决 问题 ， 这 确保 了 开发 团队 和 公司 其 他 部 门 都 
能 以 同样 的 方式 考虑 问题 。” 

类 似 ePlan Service 的 团队 ，Songkick 首 先 实现 (单元 ) 测试 驱动 开 
发 ， 然 后 扩展 到 商业 功能 。 他 们 没有 真 的 碰 到 让 他 们 改变 流程 的 质量 
问题 ， 但 是 他 们 积极 改善 流程 来 提高 效率 。 

Cowans 说 实施 实例 化 需求 说 明 的 时 候 ， 团 队 面 临 的 主要 挑战 是 理 
解 要 测试 什么 ， 如 何 使 可 执行 需求 说 明 更 可 靠 ， 以 及 如 何 使 持续 验证 
更 快 。 

一 旦 团队 习惯 于 如 何 使 用 工具 ， 他 们 就 很 容易 过 分 专注 于 用 户 界 
面 功能 ， 因 为 这 些 很 容易 考虑 。Cowans 说 : 


“我 们 花 了 太 长 时 间 测 试用 户 界 面 中 很 多 琐碎 的 地 方 ， 因 为 这 么 做 
很 容易 。 我 们 没有 用 足够 的 时 间 深 入 测试 边缘 情况 以 及 程序 的 其 他 路 
径 。 me 

他 们 通过 一 种 与 用 户 界 面 紧密 相连 的 方式 来 自动 化 可 执行 需求 说 
明 ， 所 以 测试 结果 并 不 可 靠 。 Cowans 说 在 某 些 情况 下 这 迫使 他 们 在 开 
发 完成 后 才 做 测试 ， 而 无 法 将 测试 用 作 需 求 说 明 : 

“有 人 修改 了 网 页 上 的 标点 就 导致 测试 失败 了 ， 这 很 不 好 ， 很 令 人 
温 来 ， 因 为 这 使 得 一 项 变更 所 带 来 的 影响 变 得 难以 预 估 。 所 以 很 难 实 
现 预先 更 新 整套 测试 。 结 果 ， 在 某 些 情况 下 大 家 只 得 先 写 代码 再 做 测 
试 。 

为 了 解决 这 些 问 题 ， 团 队 开始 把 测试 变 得 语义 性 更 好 ， 并 由 自动 
化 层 完 成 领域 语言 和 用 户 界 面 概 念 之 间 的 转译 ，Cowans 解 释 道 : 

“你 对 这 个 过 程 不 断 熟悉 ， 并 开始 理解 依赖 于 用 户 界 面容 易 导 致 长 
期 的 问题 。 开 发 更 专注 于 领域 的 步骤 的 定义 (在 自动 化 层 ) 有 助 于 解 
决 这 个 问题 ， 因 它 赋予 我 们 更 高 层 的 解决 问题 的 方式 。” 

他 们 所 做 的 改变 实际 上 是 开始 提炼 需求 说 明 ， 并 寻找 用 商业 语言 
表达 需求 说 明 的 方式 ， 而 不 是 用 户 界面 的 语言 。 

根据 Cowans 的 说 法 ， 团 队 用 了 6 个 月 左右 的 时 间 习 惯 实例 化 需求 
说 明 的 流程 和 工具 : 

“大 概 是 在 最 后 的 6 一 9 个 月 ， 团 队 才 觉 得 这 是 我 们 要 做 的 事情 之 
一 。 在 最 后 的 9 个 月 里 没 人 真正 质疑 我 们 如 何 描述 工作 ， 它 就 是 这 么 自 
然而 然 地 存在 着 。” 

当 不 得 不 重 写 系统 的 一 部 分 以 处 理 活 动 订阅 的 时 候 ， 团 队 才 意 识 
到 他 们 的 可 执行 需求 说 明 是 多 么 重要 。 现 有 的 一 套 专 注 于 业务 的 需求 
说 明 已 被 自动 化 成 测试 ， 这 使 得 他 们 确信 在 重 写 订阅 功能 时 没有 3 引入 
缺陷 或 减少 功能 。Cowans 说 : 

“团队 所 有 人 都 知道 此 事 省 了 不 少时 间 ， 而 我 则 觉得 测试 为 我 们 节 
省 了 50% 的 重 构 时 间 。” 


对 于 创业 公司 来 说 ， 节 省 一 个 任务 50% 的 时 间 意 味 着 很 多 。 可 执 
行 需求 说 明 有 效 地 防止 了 系统 的 回归 问题 。Cowans 说 ， 他 们 产品 环境 
的 问题 非常 少 ， 因 此 他 们 都 不 需要 缺陷 跟踪 系统 。 这 使 他 们 可 以 专注 
于 交付 新 功能 ， 而 不 是 维护 系统 。 

还 没有 活 文 档 

我 采访 Cowans 的 时 候 ， 他 们 系统 的 可 执行 需求 说 明 的 数量 已 经 增 
长 了 许多 ， 需 要 开始 考虑 重新 组 织 需求 说 明 ， 并 在 根本 上 形成 活 文档 
系统 。Cowans 说 : 

“ 刚 开始 建立 的 时 候 ， 我 们 没有 充分 考虑 测试 的 高 层 结 构 。 随 着 系 
统 的 增长 ， 我 们 只 是 随意 地 按 需 增加 新 的 测试 。 结 果 ， 在 修改 现 有 代 
码 的 时 候 ， 很 难 找到 哪些 测试 覆盖 哪些 功能 。 决 定 网 站 功能 的 高 层 描 
述 并 依 此 组 织 测 试 ， 而 不 是 简单 地 为 每 个 新 构建 的 功能 添加 新 的 测 
试 ， 这 会 很 有 帮助 。 我 认为 这 对 开发 产品 与 维护 相对 易于 理解 的 代码 
都 很 有 帮助 ， 最 终 会 形成 描述 新 功能 如 何 配 舍 现 有 功能 的 通用 语言 。” 


17.2 当前 的 流程 


Songkick 的 开发 流程 是 基于 看 板 的 。 他 们 的 产品 团队 负责 路 线 
图 ， 开 发 团队 负责 实现 。 产 品 团 队 由 产品 开发 主管 、1 名 创意 总 监 和 1 
名 交互 设计 师 组 成 。 开 发 团队 有 9 名 开发 人 员 和 2 名 测试 人 员 。 开 发 团 
队 中 ，2 人 偏重 于 客户 端 和 用 户 界 面 ， 其 他 的 偏重 于 中 间 件 和 后 台 。 
Cowans 是 CTO， 也 是 开发 团队 的 一 员 。 据 他 说 ， 公 司 试 着 在 产品 和 开 
发 之 间 融 入 尽 可 能 多 的 协作 ， 因 此 团队 间 的 边界 已 经 相当 模糊 了 。 

如 果 一 个 功能 处 在 最 高 优先 级 ， 即 将 开始 实现 时 ， 产 品 团队 会 在 
一 起 研究 用 户 体 验 和 实现 它 所 需 的 技术 。 会 议 的 产 出 就 是 线 框图 、 特 
定 用 例 的 介绍 ， 以 及 该 功能 用 户 故 事 列表 的 最 初版 本 。 

当 开 发 团队 有 足够 生产 力 开始 实现 功能 的 时 候 ， 他 们 会 与 产品 团 
队 及 可 能 实现 该 功能 的 所 有 开发 人 员 或 测试 人 员 一 起 进行 首次 会 议 。 
在 这 个 会 议 上 ， 他 们 把 功能 分 解 成 用 户 故 事 ， 一 起 为 每 个 故事 讨论 验 


收 条 件 。 验 收 条 件 被 定义 成 一 系列 需要 检查 的 点 ， 包 含 之 后 需要 完善 
的 具体 例子 。 

测试 人 员 负 责 需 求 ， 包 括 用 户 故 事 和 相关 的 验收 条 件 列表 。 他 们 
负责 维护 这 些 开发 过 程 中 的 额外 信息 。 由 于 可 用 性 和 用 户 交 互 比较 重 
要 ， 除 运行 所 有 的 可 执行 需求 说 明 外 ， 他 们 会 在 开发 后 手工 测试 每 个 
功能 的 核心 功能 点 。 因 此 在 首次 会 议 后 测试 人 员 就 开始 考虑 测试 计划 
了 。 

开发 人 员 编 写 带 实 例 的 需求 说 明 ， 测 试 人 员 进 行 审 核 ， 建 议 还 有 
哪些 需要 覆盖 的 。 然 后 开发 人 员 把 它们 都 自动 化 ， 用 TDD 实 现 所 需 的 
功能 ， 并 让 测试 人 员 可 以 访问 到 这 个 代码 分 支 。 

然后 测试 人 员 运 行 手工 测试 ， 开 始 做 探索 测试 ， 并 向 开发 人 员 提 
供 反 馈 。 一 旦 测试 人 员 和 开发 人 员 都 认为 功能 已 经 准备 好 了 ， 这 个 功 
能 就 进入 等 待 集成 的 队列 中 。 

队列 中 的 功能 会 集成 到 主 分 支 。 然 后 运行 整个 持续 验证 ， 代 码 被 
部 署 到 临时 环境 ,测试 人 员 为 核心 功能 做 最 后 的 手工 测试 。 之 后 ， 代 
码 会 上 线 进入 生产 环境 。 

顿悟 之 处 

我 询问 Cowans， 对 他 来 说 ， 实 施 实例 化 需求 说 明 的 关键 啊 哈 时 刻 
是 什么 时 候 。 他 说 : 

测试 能 看 见 的 东西 很 容易 ， 但 是 最 终 还 需要 对 软件 所 做 的 事情 有 
深刻 的 理解 ， 而 不 仅仅 是 知道 用 户 界面 长 什么 样子 。 考 虑 使 用 用 户 故 
事 和 应 用 程序 的 路 径 确实 有 很 大 帮助 。 

将 你 的 测试 视 为 一 等 公民 。 它 需要 像 应 用 程序 代码 本 身 一 样 认真 
维护 。 

测试 是 对 应 用 程序 所 做 事情 的 最 可 靠 的 描述 。 成 功 最 终 取 决 于 是 
否 构建 了 正确 的 东西 并 且 做 得 很 好 。 如 果 测 试 是 对 代码 的 描述 ， 那 么 
它们 不 仅仅 是 开发 流程 的 重要 部 分 ， 而 且 还 是 构建 产品 这 个 大 流程 的 
重要 部 分 。 他 们 能 帮助 你 理解 你 已 经 构建 了 什么 ， 并 控制 复杂 度 。 


让 流程 中 的 所 有 人 都 参与 进来 很 重要 ， 这 不 仅仅 是 开发 人 员 做 的 
事 。 实 例 化 需求 说 明 最 终 提供 了 测试 ， 这 些 测试 是 由 开发 人 员 编 写 
的 ， 并 且 产 品 负责 人 可 以 读 得 懂 。 你 应 该 好 好 利用 这 一 点 。 


17.3 训 


对 我 而 言 ，Songkick 的 重要 经 验 是 : 如 果 没 有 腾 肿 的 遗留 系统 拖 
累 你 ， 从 TDD 快 速 过 度 到 实例 化 需求 说 明 是 有 可 能 的 。 在 Songkick， 
他 们 只 是 把 它 作 为 TDD 流 程 覆 盖 到 业务 功能 的 扩展 。 

团队 构建 并 维护 网 页 系统 ， 所 以 他 们 一 开始 自动 化 测试 就 是 与 用 
户 界面 紧密 绑 在 一 起 的 。 这 导致 许多 维护 问题 ， 也 引导 他 们 开始 提炼 
需求 说 明 ， 并 在 更 高 的 抽象 层次 上 自动 化 用 户 界 面 检查 。 

他 们 花 了 大 概 一 年 的 时 间 才 开始 考虑 建立 活 文档 ， 并 看 到 了 当 午 
与 系统 的 一 部 分 功能 时 ， 这 一 点 是 多 么 重要 。 

作为 一 家 创业 公司 ，Songkick 专 注 于 交付 真正 重要 的 事情 ， 这 让 
他 们 获得 了 不 少 好 处 。 通 过 协作 制定 需求 说 明 而 获得 的 共识 确保 了 他 
们 全 都 专注 于 交付 正确 的 产品 。 第 二 重要 的 好 处 是 来 自 于 可 执行 的 需 
求 说 明 ， 因 为 这 使 他 们 能 更 早 地 发 现 问题 ， 并 能 集中 精力 交付 新 功 
能 ， 而 不 会 浪费 时 间 在 修复 缺陷 上 。 


18 章 思想 总 结 


我 为 编写 这 本 书 而 开始 的 一 系列 调研 ， 最 初 原因 是 为 了 在 外 界 验 
证 我 的 想法 。 我 要 记录 下 有 许多 团队 因 使 用 敏捷 相 天 的 技术 而 做 出 了 
很 出 色 的 产品 。 我 所 希望 看 到 的 是 他 们 使 用 了 BDD、 敏 捷 验 收 测试 ， 
或 者 我 所 称 为 的 实例 化 需求 说 明 。 我 本 以 为 自己 已 经 对 这 些 流程 了 如 
间 掌 ， 并 且 其 他 人 的 使 用 方式 也 都 与 我 如 出 一 略 。 但 是 随 着 研究 的 不 
断 深 入 ， 我 逐渐 改变 了 这 种 看 法 。 为 了 让 这 些 敏捷 技术 发 挥 作用 ， 很 
多 团队 都 对 其 做 了 调整 以 适应 自己 的 使 用 环境 。 这 也 证 明了 并 不 存在 


所 谓 的 “最 佳 实 践 "。 软 件 开发 与 使 用 环境 有 很 大 的 相关 性 ， 有 些 思想 
用 在 某 些 团队 里 得 心 应 手 ， 而 用 在 其 他 团队 里 却 水 土 不 服 。 

回顾 这 些 调研 ， 关 于 如 何 高 效 地 交付 高 质量 的 软件 产品 ， 我 的 收 
获 多 得 令 人 惊讶 。 其 中 有 些 对 我 来 说 是 全 新 的 发 现 ， 而 有 些 是 用 更 宽 
广 的 钢 角 来 看 竺 我 所 熟知 的 东西 ， 这 使 得 我 对 这 些 做 法 背后 的 实际 推 
动力 有 了 更 深 的 理解 。 作 为 对 本 书 的 总 结 ， 我 想 提出 我 所 学 到 的 五 大 
最 重要 方面 。 


在 Bridging the Communication Gap 一 书 里 ， 我 提 到 需求 说 明 工 作 
坊 有 两 种 主要 和 输出。 一 种 是 有 形 的 : 例子 或 者 需求 说 明 。 另 一 种 是 无 
形 的 : 通过 交谈 对 需求 达成 的 共识 。 我 提 到 了 这 种 无 形 的 共识 甚至 可 
能 比 有 形 的 例子 还 重要 。 结 果 却 发 现 ， 真 实情 况 要 复杂 得 多 ， 我 在 为 
本 书 做 调研 的 过 程 中 发 现 了 另 一 种 无 形 的 输出 。 

uSwitch、Sabre、Beazley 以 及 Weyerhaeuser 的 例子 表明 了 协作 制定 
需求 在 团队 的 氛围 里 引发 了 变化 。 结 果 ， 开 发 人 员 、 分 析 师 以 及 测试 
人 员 协 作 得 更 融 治 ， 并 且 团 队 整 合 得 比 以 往 更 好 。5| 用 Wes Williams 
的 一 句 话 ， 在 协作 制定 需求 之 后 “信任 太 棒 了 ”。 

我 共事 过 的 许多 公司 所 使 用 的 软件 开发 模型 都 是 以 互相 不 信任 为 
前 提 的 。 商 业 用 户 将 需求 告诉 分 析 师 ， 却 不 信任 分 析 师 所 做 的 详细 说 
明 ， 最 后 还 需要 对 需求 说 明 进 行 签收 。 分 析 师 将 需求 告诉 开发 人 员 ， 
却 不 信任 开发 人 员 交 付 的 内 容 ， 因 此 测试 人 员 需 要 使 用 比较 独立 的 方 
式 进行 检查 ， 以 确定 开发 人 员 是 否 诚实 。 开 发 人 员 也 不 信任 测试 人 
员 ， 测 试 人 员 报 告 缺陷 后 ， 开 发 人 员 不 会 立即 检查 代码 ， 而 只 是 说 无 
法 重 现 ， 或 者 说 “在 我 的 机 器 上 是 好 的 ”。 所 以 测试 人 员 被 训练 成 不 信 
任 任何 人 ， 几 乎 就 像 个 熟练 的 间谍 一 般 。 

一 个 基于 互 不 信任 的 模型 不 仅 会 产生 敌对 的 状态 ， 还 将 滋生 大 量 
的 官僚 行为 。 据 说 ， 对 需求 进行 签收 是 用 户 为 了 确保 分 析 师 所 要 做 的 
事情 是 正确 的 。 而 事实 上 呢 ， 签 收 只 是 为 了 防备 以 后 出 1 现 功 能 缺失 时 


分 析 师 受到 责备 ! 因为 每 个 人 都 需要 了 解 事情 的 进展 情况 ， 所 以 需求 
说 明 需 要 通过 变更 管理 流程 ;) 而 事实 上 ， 不 会 有 人 因为 未 将 某 项 变更 
内 容 告诉 他 人 而 受到 责备 。 据 说 ， 在 测试 过 程 中 冻结 代码 是 为 测试 人 
员 提 供 一 个 更 加 稳定 的 环境 。 这 也 同样 确保 了 开发 人 员 不 会 由 于 在 测 
试 过 程 中 修改 了 系统 而 受到 责备 。 表 面 上 ， 这 整套 体系 是 为 了 提供 更 
好 的 质量 。 而 事实 上 ， 这 不 3 过 是 推 放 的 借口 而 已 。 

这 纯粹 是 浪费 ! 我 们 可 以 在 商业 用 户 、 分 析 师 、 开 发 人 员 以 及 测 
试 人 员 之 间 建 立信 任 ， 这 样 可 以 消除 推 诱 的 借口 以 及 随 之 而 来 的 官僚 
作风 。 协 作 制 定 需求 说 明 融 是 开始 建立 这 种 信任 的 一 个 上 好 的 方式 。 


18.2 协作 需要 事先 准备 


在 Bridging the Communication Gap 一 书 中 ， 除 了 提 到 举办 “预计 划 
会 议 ”(pre-planning meeting) 是 实施 迭代 流程 的 一 种 好 办 法 外 ， 我 并 未 
更 多 地 谈 及 工作 坊 的 准备 工作 。 我 引入 预计 划 会 议 是 因为 在 每 个 工作 
坊 开始 之 初 ， 我 们 都 会 在 确认 例子 的 重要 特性 上 花费 大 量 的 时 间 ， 而 
真正 的 讨论 是 在 确立 工作 内 容 之 后 才 正 式 开始 的 。 而 现在 我 知道 了 ， 
除 “ 预 计划 会 议 ” 外 ， 还 有 其 他 更 8 多 的 做 法 。 

有 些 团队 在 准备 阶段 使 用 了 其 他 方式 ， 在 与 他 们 交谈 之 后 ， 我 知 
道 了 “协作 制定 例子 ”的 流 9 程 有 两 个 步骤 。 第 一 步 ， 有 人 准备 基础 实 
例 。 第 二 步 ， 团 队 讨论 这 些 例 子 并 进行 扩展 。 准 备 阶 段 的 目的 是 确保 
例子 的 基础 问题 已 经 解决 ， 并 且 这 些 例子 有 固定 格式 方便 团队 进行 阅 
读 讨论 。 而 这 些 事情 可 以 只 由 一 两 个 人 完成 ， 这 样 整个 大 的 工作 坊 可 
以 更 加 高 效 。 

有 些 团 队 所 在 项 目的 需求 模糊 不 清 ， 需 要 大 量 的 事先 分 析 ， 因 此 
他 们 的 准备 阶段 会 在 协作 工 11 作 坊 开始 前 2 周 开始 。 这 样 分 析 师 可 以 与 
商业 用 户 交谈 ， 从 他 们 那里 收集 实例 ， 并 开始 提炼 实例 。 而 有 些 团 队 
拥有 更 稳定 的 需求 ， 他 们 只 需 提 前 几 天 准备 实例 ， 收 集 并 解决 一 些 明 
显 的 问题 。 这 些 方式 都 有 助 于 更 加 高 效 地 举办 大 型 工作 坊 。 


18.3 协作 的 方式 多 种 多 样 


在 Bridging the Communication Gap 一 书 中 ， 我 推荐 “大 型 的 全 体 工 
作坊 ”作为 协作 制定 需求 14 说 明 的 最 佳 方式 。 与 工作 在 不 同 环境 的 团队 
交谈 之 后 ， 我 认识 到 了 现实 并 非 如 此 简单 。 

许多 团队 友 现 大 型 工作 坊 在 一 开始 很 有 用 ， 可 以 用 于 传递 领域 知 
识 ， 还 可 以 确保 开发 人 员 、 测 试 人 员 、 业 务 分 析 师 以 及 项 目 干 系 人 之 
间 对 预期 结果 有 一 致 的 认同 。 然 而 大 多 数 团队 在 一 段 时 间 之 后 就 不 再 
举行 大 型 工作 坊 了 ， 因 为 他 们 发 现 这 很 耗 时 并 且 很 难 协调 所 有 人 的 会 
议 时 间 。 

一 旦 整个 体系 成 形 、 信 任 得 到 改善 、 开 发 人 员 与 测试 人 员 了 解 了 
很 多 领域 知识 之 后 ， 小 型 工作 坊 或 者 专门 会 议 此 时 就 足以 产生 好 的 需 
求 说 明了 。 许 多 团队 的 做 法 是 “ 谁 有 兴趣 谁 参 加 ”， 会 议 人 员 只 包含 了 
接手 该 用 户 故 事 的 相关 人 等 。 如 果 其 他 人 需要 变更 某 个 功能 ， 只 需 
活 文档 系统 就 能 明白 。 


如 果 我 们 将 业务 流程 文档 作为 实例 化 需求 说 明 的 最 终 目的 ， 那 么 
许多 常见 的 目 动 化 问题 与 维护 问题 就 不 复 存 在 了 。 例 如 ， 创 建 过 于 复 
杂 的 脚本 来 模拟 软件 的 创建 方式 ， 这 种 做 法 的 缺点 就 显而易见 了 。 脚 
本 最 终 都 会 变 得 难以 维护 ， 其 用 于 沟通 的 价值 微乎其微 。 

在 社区 里 ， 我 们 几 年 前 就 发 现 了 这 个 问题 ， 并 且 许 多 实践 者 建议 
团队 不 要 将 验收 测试 编写 成 工作 流 。 虽 然 对 多 数 案例 来 说 ， 此 话 不 
假 ， 然 而 对 于 领域 本 身 就 是 工作 流 的 情况 (如 支付 处 理 ) Ales 
助 。David PeterSon 看 到 了 工作 流 在 FIT 里 被 滥用 的 情况 ， 为 此 他 专门 
编写 了 concordion 以 正视 听 ， 他 的 做 法 离 “ 编 写 需求 说 明 而 非 脚 本 ”的 观 
点 又 更 近 了 一 步 。 这 是 个 不 错 的 经 验 法 则 ， 但 是 对 于 开发 网 站 来 说 却 
并 不 适用 。 问 题 在 于 它 未 能 使 验收 测试 (需求 说 明 ) 模型 与 业务 模型 


RIF —BO ， 业 务 领 域 里 的 一 个 细微 变动 都 会 对 测试 产生 需 弹 效应 ， 
使 得 测试 变 得 难以 维护 。 


注释 : (DSee http://dannorth.net/2011/01/31/whose-domain-is-it- 
anyway 


如 果 我 们 专注 于 将 业务 流程 文档 化 ， 需 求 说 明 的 模型 将 与 业务 模 
型 一 致 ， 并 且 变 更 也 将 对 称 。 业 务 领域 模型 的 一 个 细微 变更 只 会 在 需 
求 说 明 与 测试 里 产生 同样 细微 的 变化 。 在 开始 编写 软件 之 前 ， 我 们 可 
以 将 业务 流程 很 好 地 文档 化 ， 而 即使 所 使 用 的 技术 改变 了 ， 需 求 说 明 
也 可 维持 不 变 。 长 期 来 看 ， 阐 述 业务 流 程 的 需求 说 明 更 加 物 有 所 值 。 
商业 用 户 可 以 参与 业务 流程 的 文档 化 ， 并 且 相 比 与 软件 有 关 的 验收 测 
试 ， 他 们 还 可 以 更 好 地 提供 反馈 。 

以 上 这 些 也 告诉 我 们 做 什么 自动 化 以 及 如 何 上 自动 化 。 使 需求 说 明 
中 包含 已 创建 的 测试 概念 ， 或 使 其 适应 于 用 户 界面 交互 ， 可 以 很 容易 
地 发 现 缺 陷 。 如 果 需 求 说 明 记 录 了 业务 流程 ， 那 么 目 动 化 层 融会 在 软 
件 中 运行 这 些 业 务 流 程 。 技 术 化 流程 、 脚 本 以 及 模拟 的 界面 交互 要 做 
的 就 是 这 些 事情 。 自 动 化 本 身 不 是 目的 ， 它 只 是 运行 业务 流程 的 一 个 
工具 而 已 。 

为 了 创建 可 靠 的 文档 ， 我 们 必须 对 其 频繁 验证 。 利 用 自动 化 可 以 
做 到 频繁 验证 ， 并 且 不 需要 多 少 代 价 ， 但 它 不 是 唯一 方式 。 有 些 东 西 

无 法 很 好 地 自动 化 ， 比 如 易 用 性 。 但 是 我 们 仍然 可 以 对 需求 说 明 的 一 
部 分 进行 频繁 验证 ， 这 样 就 解决 了 有 些 需 求 说 明 难 以 自动 化 的 问题 ， 
这 也 是 许多 团队 想 要 避免 的 问题 。 


18.5 活 文档 带 来 的 长 期 价值 


我 采访 的 这 些 人 几乎 都 经 历 过 由 更 快 交 付 与 更 高 质量 所 带 来 的 短 
期 效益 ， 但 是 “清理 测试 "的 团队 同样 获得 了 相当 不 错 的 长 期 效益 。 作 
为 一 名 咨询 师 ， 我 帮助 许多 团队 实施 了 这 些 实 践 ， 但 是 由 于 我 没有 与 
他 们 长 期 一 起 工作 ， 所 以 我 基本 都 无 法 体验 到 它们 融 来 的 长 期 效应 。 


平 运 的 是 ， 早 期 采用 这 些 实践 的 团队 到 目前 已 经 使 用 了 有 六 七 年 的 光 
景 了 ， 他 们 也 已 经 看 到 了 不 错 的 长 期 效益 。 

爱 荷 华 州 助 学 贷 款 公司 由 于 有 了 可 靠 的 文档 ， 所 以 可 以 很 快 地 变 
更 业务 模型 。ePlan Services 团 队 在 其 中 一 名 核心 队员 不 在 的 情况 下 也 
能 良好 运作 。Sierra 项 目的 团队 在 接 到 支持 请 求 时 将 “测试 "用 作 支 持 文 
档 。 从 这 点 来 看 ， 我 认为 不 应 该 将 他 们 使 用 的 称 作 “测试 ”， 因 为 不 是 
用 它们 来 1 测试 软件 的 ， 创 建 它 们 的 目的 是 将 它们 用 作 可 靠 文 档 ， 并 提 
供 参 考 。 

大 多 数 团 队 在 反复 试验 中 采用 了 活 文档 系统 ， 是 由 于 他 们 要 寻找 
更 简单 的 方式 来 维护 测试 。2 他 们 重组 测试 是 为 了 测试 更 加 稳定 ， 使 得 
测试 与 业务 中 的 模型 相 一 致 。 他 们 重组 了 包含 测试 的 目录 ， 这 样 在 变 
更 时 能 更 方便 地 找到 相关 的 测试 ， 并 且 还 用 类 似 于 商业 用 户 考虑 系统 
功能 的 组 织 方式 演化 了 一 个 文档 系统 。 

在 这 一 点 上 ， 我 可 以 很 有 信心 地 断言 ， 如 果 一 个 新 的 团队 特意 从 
一 开始 就 创建 活 文档 系统 ，4 而 不 是 经 过 多 年 的 试验 与 摸索 后 才 去 创 
建 ， 那 么 他 们 很 快 就 将 大 有 斩获 。 

请 铭记 以 上 这 点 ， 我 诚 尽 地 邀请 你 与 团队 一 起 试 试看 。 试 过 之 后 
请 与 我 分 享 你 的 体会 。 你 可 5 以 通过 Email 联 系 我 ， 地 址 是 
gojko@gojko.como 


附录 A 资源 
za 
ca 


Gojko Adzic,Bridging the Communication Gap:Specification by 
Example and Agile Acceptance Testing(Neuri,2009). 

Gojko Adzic,Test Driven.NET Development with FitNesse 
(Neuri,2008). 

David Anderson,Kanban:Successful Evolutionary Change for Your 
Technology Business(Blue Hole Press,2010). 

Mijo Balic, Ingrid Ottersten,and Peter Corrigan,Effect Managing 
IT(Copenhagen Business School Press,2007). 

Mijo Cohn, Agile Estimating and Planning (Robert C.Martin Series) 
(Prentice Hall,2005) 

Lisa Crispin and Janet gregory,Agile Testing:A Practical Guide for 
Testers and Agile Teams(Addison-Wesley Professional,2009). 

Kev Darling,F-16 Fighting Falcon (Combat Legend) (The Crowood 
Press,2005). 

Mark Denne and Jane Cleland-Huang, Software by Numbers:Low- 
Risk,High-Return Development (Prentice Hall,2003). 

Eric Evans,Domain-Driven Design:Tackling Complexity in the Heart 
of Software (Addison-Wesley Professional,2003). 

Steve Freeman and Nat Pryce,Growing Object-Oriented 
Software,Guided by Tests (Addison-Wesley Professional,2009). 

Donald C.Gause and Gerald M.Weinberg,Exploring 
Requirements:Quality Before Design (Dorset House Publishing 
Company,1989). 

Capers Jones,Estimating Software Costs:Bringing Realism to 
Estimating,2nd ed.(McGraw-Hill Osborne,2007). 


Craing Larman and Bas Vodde,Practices for Scaling Lean & Agile 
Development:Large, Multisite,and Offshore Product Development with 
Large-Scale Scrum (Pearson Education,2010). 

Rick Mugridge and Ward Cunningham, Fit for Developing 
Software:Framework for Integrated Tests (Prentice Hall,2005). 

Mary Poppendieck and Tom Poppendieck,Lean Software 
Development:An Agile Toolkit (Addison-Wesley Professional,2003). 


James Shore and Shane Warden,The Art of Agile Development 
(O'Reilly Media,2007). 

Gerald Weinberg,Quality Software Management: Vol.1,Systems 
Thinking (Dorset House Publishing, 1992). 


在 线 资源 

本 书 提供 的 所 有 在 线 资 源 的 链接 及 更 多 可 以 在 下 面 的 网 站 上 找 
到 。 

工具 


Concordion:http//www.concordion.org. 
Cucumber:http://cukes.info. 

FitNesse:http://jbehave.org 

Green Pepper:http://www.greenpeppersoftware.com. 
JBehave:http://jbehave.org. 

Robot Eramework:http://www.robotframework.org. 
SpecFlow:http://www.specflow.org. 
TextTest:http://www.texttest.org. 
Twist:http://studios.thoughtworks.com/twist-agile-test-automation/. 


视频 

Gojko Adzic,"Challenging 
Requirements, "http://gojko.net/2009/12/10/challenging-requirements/. 

Dan North,"How to Sell BDD to the 
Business, "http://skillsmatter.com/podcast/agile-testing/how-to-sell-bdd-to- 
the-business. 

Hemal Kuntawala,"How we build quality software at 
USwitch.com,"http://skills matter.com./podcast/agile-testing-how-we-build- 
quality-software-at-uswitch-com. 

Björn Regnell,"Supporting Roadmapping of Quality 
Requirements, "http://oredev.org/videos/supporting-roadmapping-of-quality- 
requirements. 


演讲 


Tim Andersen,"Persona Driven 
Development, "http://www.umsec.umn.edu/events/Code-Freeze- 
2010/PDD;http://timandersen.net/presentations/Persona_Driven_Developm 
ent.pdf. 

Mark Durrand and Damon Morgen,"Creating a Lean Business from 
the inside out:Technical innovation at uSwitch.com.to reduce 


waste,"http://www.slideshare.nte/markdurrand/spa2010-uswitch. 


文章 


Gojko Adzic,"Agile in a Start-up Games Development 
Studio, "http://gojko.net/2010/05/19/agile-in-a-start-up-games-development- 
studio/. 

Gojko Adzic:Are tools necessary for acceptance testing,or are they just 
evil?http://gojko.net/2010/03/01/are-tools-necessary-for-acceptance-testing- 
or-are-they-just-evil. 

Gojko Adzic,"Examples make it easy to spot 
inconsistencies, "http://gojko.net/2009/05/12/examples-make-it-easy-to- 
spot-inconsistencies/. 

Gijko Adzic:How to implement UI testing without shooting yourself in 
the foot,http://gojko.net/2010/04/13/how-to-implement-ui-testing-without- 
shooting-yourself-in-the-foot-2/. 

Gijko Adzic:Improving testing practices at 
Google,http://gojko.net/2009/12/07/improving-testing-practices-at-google/. 

Gojko Adzic,"QUPER model for better 
requirements, "http://gojko.net/2009/11/04/quper-model-for-better- 
requirements/. 

Gojko Adzic,"Shock therapy agile agile adoption at 
7 Digital, "http://gojko.net /2009/12/08/shock-eherapy-agile-adoption-at- 
7digital/. 

Michael Bolton," Acceptance Tests:Let's Change the 
Title, Too, "http://www.developsense.com/blog/2010/08/acceptance-tests 
lets-change-the-title-too/. 

Michael Bolton,"Testing 
vs.Checking,"http://www.developsense.com/blog/2009/08/testing-vs- 
checking/. 

Alistair Cockburn,"Sacrifice One 
Person, "http://alistair.cockburn.us/Sacrifice+one+person+strategy. 

Craig Larman and Bas Vldde," Acceptance Test-Driven Development 
with Robot 
Framework, "http"//code.google.com/p/robotframework/wiki/ATDDWith 
RobotFrameworkArticle. 

Craig Larman and Bas Vodde,"Feature Teams 
Primer, "http://www.featureteams.org/feature_team_primer.pdf. 


Dan North,"Whose domain is it 
anyway ?"http://dannorth.net/2011/01/31/whose-domain-is-it-anyway/. 

Björn Regnell,Richard Berntsson Svensson,and Thomas 
Olsson,"Supporting Roadmapping of Quality Requirements,"TEEE 
Software 25,no.2(Mar/Apr 2008):43-47 

James Shore," Alternatives to Acceptance 
Testing, "http://jamesshore.com./Blog/Alternatives-to-Acceptance- 
testing. html. 

James Shore,"The Problems with Acceptance 
Testing, "http://jamesshore.com/Blog/The-Problems-With-Acceptance- 
Testing.html. 

Lance Walton,"Writing Maintainable Acceptance 
Tests,"http://www.casual micacles.com/blog/2010/03/04/writing- 
maintainable-acceptance-tests/. 

漫画 

Chris Matts,"Real Options at Agile 
2009,"http"//www/lulu.com/product/file-download/real-options-at-agile- 
2009/5949486. 

培训 课程 

Gojko Adzic:http://neuri.co.uk/training. 

Object 
Mentor:http://objectmentor.com/omTrining/omi_training_index.html. 

Lisa Crispin and Janet 
Grgory:http://www.janetgregory.ca/training.htm. 

Elisabeth Hendrickson:http://www/qualitytree.com/workshops/. 

Pyxis Technologies:http://pyxis-tech.com/en/our-offer/training. 

Tech Talk:http://www/techtalk.at/training.aspx. 

Rick Mugridge:http://www.rimuresearch.com/Coaching.html. 


